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PREFACE 



Manual Objectives 

This manual provides a tutorial for the MICR02 assembler. It 
introduces the MICRQ2 language and gives examples of its use. The 
appendixes contain a reference section for the MICR02 language, 
examples of the input and output files, and a listing of the error 
messages produced by HICR02. 



Intended Audience 

This manual is intended for assembly language programmers and hardware 
engineers. The reader is assumed to be familiar with microprogramming 
and the characteristics of the architecture for which the 
microprograms are to be written. 



Structure of this Document 

This manual introduces the language constructs of MICR02. The 
identification constructs are presented first. Then the process of 
defining fields and macros is discussed. Then microinstructions and 
"he process of allocation is considered. Finally, conditional 
assembly, output listings, and the use of MICRO 2 is described. 



CHAPTER 1 
INTRODUCTION TO MICR02 



The MICR02 assembler converts microprograms written in its source 
language to absolute object code. The source language of MICR02 
allows you to define names for fields and macros and then use these 
names in specifying the actions to be performed by the microprogram. 



The MICRO 2 assembler performs two logical functions: translation and 
address selection. In translating names within a microinstruction to 
the appropriate set of bits, the assembler performs valuable syntax 
and validity checking. In assigning addresses, the assembler helps 
you lay out branches and allocate storage in an effective manner. 



1.1 TRANSLATION 

To construct an object microprogram, the assembler interprets a source 
microprogram written in a language that defines and uses names to set 
the appropriate bits in the microwords of the program. Names, called 
field-names, are defined to identify a sequence of bits within the 
microword. For example, bits 22 through 19 are associated with the 
field-name ALU by the following field-definition: 

ALU/-<22:19> 

Names, called value-names, are then defined to represent some or all 
of the possible values for the field. Value-names are specified 
following a field definition by a series of name and value pairs, 
connected by the character "■". For example, the value-names ADD, 
SUB, ANO, OR, and A are associated with the specified values for the 
field ALU, as foi lows: 

ALU/-<22:19> 
ADD-0 
SUB-1 
AND-2 

OR-3 
A-J* 
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phen the following field-setting sets bits 22 through 19 to the value 
ki 

ALU/A 



In addition to this basic ability to refer to fields and their values 
symbolically, macros can be defined to produce a notation in which the 
functions of the microword, not the specific field-settings, are 
given. For example: 

POP STACK "MEMFNC/STKRD, ALU/A, CLKT1/YES" 



The above macro-call within a microinstruction is equivalent to 
setting the three fields shown in the macro definition, but is more 
convenient and readable. 



1.2 ADDRESS SELECTION 



MICR02 performs two types of allocation, either SEQUENTIAL or RANDOM. 
Further, it lets you select an address for a microinstruction or leave 

the address selection to the assembler. If you are using a RANDOM 
1 location algorithm, you can make assertions about the relationships 
among a set of addresses and MICR02 will select an appropriate set of 
addresses. 



1.3 PROGRAM STRUCTURE 

The MICR02 assembler is a line-oriented processor, which accepts a 
sequence of input lines written in MICR02 source language and produces 
a listing file and an object module. 



MICR02 accepts continuation lines in three cases: 

o Expressions 

o Macro-bodies 

o Microinstructions 

In each case the line to be continued must have a "," as its last 
nonblank character. 



The input to MICH02 is a source program. A MICR02 source program can 
xontain one or more memories. The bit-numbering direction and the 
Program radix apply to the entire program. The following sections 
describe the way in which the direction and radix are extablished. 
Then the fundamental program unit, the memory, is considered. 
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1.4 SPECIFYING THE BIT NUMBERING 

The . LTOR and .RTOL keywords define the way in which the bits of your 
microword are numbered, so that when you define a field MICR02 knows 
whether to count from the left end or the right end of the word. The 
form of the bit-numbering keyword line is the keyword itself, namely: 

.LTOR 
.RTOL 

The .LTOR keyword directs MICR02 to consider the bits of the microword 
numbered from left to right. The .RTOL keyword directs MICR02 to 
consider the bits numbered from right to left. 



For example, suppose you have a 16 
12 through 15 of that word. If 
the bits are numbered from left to 



bit word and you refer to the bits 
you specify the .LTOR keyword, then 
r ight as fol lows: 



111111 

0123456789012345 
H + 

' x x x x< 



And MICR02 considers bits 12 through 15 as the rightmost four bits of 
the word. However, if you specify the .RTOL keyword, then the bits 
are numbered from right to left as follows: 



111111 
5432109876543210 



X X X X 



And MICR02 considers bits 12 through 15 as leftmost four bits of the 
word. 



If no bit-numbering keyword is given, then .LTOR is assumed. 



MICR02 uses the first .LTOR or .RTOL keyword it finds to establish the 
direction in which the bits are numbered and ignores any subsequent 
bit-numbering keywords in the program. 
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IDENTIFYING THE RADIX 



In a source program, MICR02 interprets some numbers according to the 
program radix and considers other numbers to always be decimal. 
MICR02 considers a number with a decimal point to be a decimal number 
and a number without a decimal point to be an integer. The way in 
which an integer is interpreted depends on the context in which it 
appears. The values that are interpreted according to the program 
radix are identified in the following chapters. 



The program radix is set by either the .OCTAL or .HEXADECIMAL 
keywords. The form of the .OCTAL and .HEXADECIMAL keyword-line is 
simply the keyword itself, as follows: 

.OCTAL 
.HEXADECIMAL 

If you include the .OCTAL keyword, any value in the program that is 
interpreted according to the program radix is interpreted as octal. 
If you include the .HEXADECIMAL keyword, such values are interpreted 
as hexadecimal. 



The program radix can be set only once in a program. MICR02 uses the 
first program radix line it finds to establish the program radix and 
gnores any subsequent program radix lines in the program. 



» 



1.6 MEMORIES 

A program can be divided into as many as seven sub-programs, or 

memories. Except for the bit-numbering and program radix, which can 

be specified only once in a program, all other constructs are 

considered to belong to a memory. Each memory has its own 

address-space, word-width, field- and macro-definitions and 
microinstructions. 



1.6.1 Single Memory Program 



If a program contains only one sub-program (memory) then the notion of 
program and memory can be indistinguishable. 
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1.6.2 Mul ti pie-Memories 

If a program contains more than one sub-program, then each sub-program 
is associated with a particular memory. You can have as many as seven 
separate sub-programs. 

The beginning of a section of the memory is specified by a 
memory- indicator keyword. The memory- i ndicator keywords are as 
fol lows: 

.UCODE 
.DCODE 
.ECODE 
. I CODE 
.OCODE 
•CCODE 
.MCODE 

The identification, definitions, and instructions following that 
memory- indicator and up to the end of the program or another 
memory- indicator are associated with the specified memory. 



1.6.2.1 Mixing Memories - You can switch back and forth among 
memories in your program. For example, suppose you have a special 
instruction decode memory (D) and an instruction interpretation memory 
(I). You can either write the program in two pieces as shown 
symbolically in the following diagram: 



+- 



! .RTOL | 

! .OCTAL ! 

i .DCODE i 

j (identification) j 

] (definitions) | 



i i 

j (instructions) j 
+ + 

| . I CODE j 
j (identification) J 

j (definitions) j 

i i 

i i 

j (instructions) j 

+ + 
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fcr you can group the decode and interpretation parts for each 
instruction as represented in the following diagram: 

+ + 

i .RTOL ! 

! .OCTAL | 
+ + 

i .DCODE ; 
| (identification) J 



i 



(def ini tions) 



j . I CODE ; 

! (identification) | 

j (definitions) j 
+ + 

! .DCODE j 

] (instructions) | 
+ + 

; . I CODE ! 
+ + 

J (instructions) j 
+ + 

i i 

i • • • i 
+ + 

! .DCODE ' 



! (instructions) j 
+ + 

i . I CODE ; 

j (instructions) | 
+ + 



CHAPTER 2 
PROVIDING IDENTIFICATION 



MICR02 includes directives that make the resulting program easy to 
access and understand. Using these directives, you can provide a 
title and subtitle for your microprogram, include a version number, 
create a table of contents, specify the paging of the program, define 
the number of bits in the microword, and add comments to the program. 



2.1 PROVIDING A TITLE FOR YOUR PROGRAM 

The .TITLE keyword-line supplies a title for MICR02 to use as part of 
the heading of the output listing. MICR02 reproduces the quoted 
string following the .TITLE keyword at the top of each page of your 
listing as part of the first line of the heading. The -TITLE 
keyword- line has the following form: 

.TITLE "title-string" 

For example, supppose you give the following .TITLE line: 

.TITLE "XYZ Machine" 

The title that appears as part of the heading on each page of your 
1 i sting is: 

XYZ Machine 



A title can be specified only once in a memory. MICR02 uses the text 
given in the first .TITLE keyword- line it finds and discards any 
subsequent .TITLE keyword- 1 ines in the memory. 
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^.2 ADDING A VERSION NUMBER 



The .VERSION keyword-line supplies a version number for MICR02 to use 
as part of the heading of the output listing. The .VERSION 
keyword- 1 ine has the following form: 

.VERS I 0N/"vers ion-no" 

MICR02 prints the version-no as part of the subtitle. The version-no 
can be any MICR02 name or number. If version-no is a number, MICR02 
interprets it according to the program radix and prints it on the 
output listing subtitle line as a decimal number. 

For example, suppose you give the following .VERSION line: 

.VERSI0N/"10" 

If the program radix is octal, MICR02 includes the version number "8" 
in the subtitle. 



2.3 ADDING A TABLE OF CONTENTS 

The .TOC keyword- line supplies a subtitle and adds an entry to the 
table of contents. MICR02 reproduces the text given in quotes 
following the .TOC keyword as part of the second line of the page 
heading of the output listing. 

Suppose you add the following .TOC keyword-line to your program: 

•TITLE "XYZ Machine - Version IB" 
.TOC" I ntroductory Remarks" 

Then the subtitle that appears on the next page of your listing is: 

Introductory Remarks 



MICR02 reproduces the text from the .TOC keyword-lines at the front of 
your listing to provide a table of contents for the listing. You can 
create an attractive table of contents by indenting the text on the 
.TOC lines to indicate subordinate topics as shown in the output 
listing of the sample program given in Appendix B. 

You can add blank lines to format your table of contents by including 
.TOC keywords that have a null string as text. For example, suppose 
you add the following .TOC keywords to your program: 

TOC "Introductory Remarks" 

TOC "" 

TOC "Field Definitions" 

• • 

TOC "" 

TOC "Macro Definitions" 
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The table of contents in your output listing is double spaced by the 
null strings as follows: 

; TABLE OF CONTENTS 

1 Introductory Remarks 

6 

7 Field Definitions 

2U 

25 Macro Definitions 



The number that appears in each table of contents line is the line 
number assigned by MICR02 to that line in the output listing. Using 
this line number, you can quickly locate the place in the listing 
where the referenced information appears. 



2.4 PAGING YOUR PROGRAM 

The .PAGE keyword- line indicates a new listing page and, optionally, 
provides a table of contents entry and a subtitle. 



To simply indicate a new page, you include the .PAGE keyword without 
any text string, as follows: 

.PAGE 

MICR02 starts a new page in the output listing and places the .PAGE 
keyword on the first line of that page following the heading, 



To start a new page, add a subtitle, and make an entry in the table of 
contents, you add a text string to the .PAGE keyword-line, as follows: 

.PAGE "text-string" 

MICR02 starts a new page, using the text string given as the subtitle 
and includes the text string in the table of contents. 



A .PAGE keyword with a text-string is operationally equivalent to a 
.TOC keyword with that text string followed by a .PAGE keyword without 
a text string. 



You can use as many .PAGE keywords in the program as you wish. A 
microprogram that is paged so that each topic appears on a new page is 
easy to read initially and convenient to reference at a later time. 
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).5 SPECIFYING THE MICROWORD WIDTH 



The .WIDTH keyword- line specifies the number of bits in the microword. 
A .WIDTH keyword-line consists of the keyword .WIDTH, followed by a 
slash and the number of bits in the word, as follows: 

.WIDTH/number-of-bi ts 



The number given for number-of-bi ts is always interpreted by MICR02 as 
a decimal number. Thus to define a microword that consists of bk 
bits, you include the following line in your microprogram: 



.WIDTH/6i* 



The maximum value that can be given for number-of-bi ts is 128. 

MICR02 uses the first .WIDTH keyword-line it finds to establish the 
width of the microword for the memory and it rejects any subsequent 
•WIDTH keyword- 1 ines in the memory. 



If you don't specify the width, MICR02 deduces the word width from the 
field definitions. It assumes the width of the word to be the value 

ermed by adding one to the largest bit position specified in the set 

f field-definitions. 



I 



2.6 COMMENTS 

Comments can be included anywhere in the program. A comment begins 
with a ";" character and ends at the end of the line. 



You can enter full line comments by starting the line with a ";" 
character. You can add comments to lines by following the last 
character on the line by some spaces and the ";" character. 

For examples of comments, see the sample program in Chapter 9. 



CHAPTER 3 
DEFINING FIELDS AND VALUES 



The set of bits within the microword that make up a particular field 
can be associated with that field name. Further, a set of qualifiers 
can be defined that add semantic meaning to the field and a set of 
value-names can be defined to set the field. 



The simplest form of a field-definition defines a name for a field as 
fol lows: 

ALPHA/-<6:0> 

The above definition associates the field name ALPHA with bits 6 
though of the microword. 



The addition of value-definitions permits the field to be set as well 
as referenced symbolically. For example: 

ALPHA/-<6:0> 
Al-1 
A2-2 
A3-3 

The above definitions associate the value-name Al with the value 1, A2 
with 2, and A3 with 3 and make the following field-setting possible: 

ALPHA/A2 

The above field-setting sets the field A (bits 6 through 0) of the 
microword to the value A2 (2). 



The addition of qualifiers permit default settings, parity adjustment, 
and the like. The following sections describe the process of defining 
field-names and value-names. 
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. 1 DEFINING NAMES FOR FIELDS 



A field-definition consists of the name followed by the separator '/■' 
followed by the position of the bits within the word to be associated 
with the field name followed by a list of one or more qualifiers. The 
form is: 

field-name /■ < lef t-bi t:r ight-bi t > { , qualifier ... } 



The field-name can be any valid MICR02 name. The rules for forming 
MICR02 names are given in Section 3.2. 



The left-bit and right-bit are decimal numbers that identify the 
beginning and end bits of the field in the microword. If you 
specified right-to-left bit numbering, then the left-bit must be 
greater than or equal to the right-bit. If you specified 
left-to-right bit numbering, then the left-bit must be less than or 
equal to the right-bit. 

Qualifiers are described in Section 3.3. 

Consider the following field-definitions: 

.RTOL 
.OCTAL 
A/-<7:i»> 
B/«<3:0> 

C/-<7:3> 

D/-<2> 

E/-<1:0> 



These definitions identify the fields of the microword as shown in the 
following diagram: 

7 6 5 *• 3 2 10 
+ _+ 

1 k I R ' 
i * i D i 
+ + 

1 C ' D ■ E ' 



As you see, you can define overlapping fields, like A and C. MICRO 2 

knows, for *ach bit of the micropore both its value (0 or 1) and its 

status (unset or set). MICR02 warns you if you try to define the 
ftate of a bit more than once. 
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3.2 NAMES 

MICR02 allows a name to be made up of characters from the following 
set: 

A B C . ..Z Upper case letters 
a b c ... z Lower case letters 
1 2 ... 9 Numbers 
! Exclamation mark 

# Hash mark 
£ Ampersand 

( Left parenthesis 

) Right parenthesis 

< Left angle bracket 

> Right angle bracket 

* Asterisk 
+ plus sign 

minus sign 

per i od 
? question mark 
_ Underscore 

Space and tab 



MICR02 considers all the following to be valid names: 

A12 
!!! 
2+3*6 
B*C? 



A name can begin with the period character, but such names make the 
program confusing for another programmer to read. Further, a future 
version of MICR02 might use the name you chose as a keyword. Keyword 
names are reserved. You cannot use a keyword as a name and, 
therefore, your program would not function correctly under the new 
version of MICR02. 



A name can begin with a number if it contains characters within it to 
distinguish it from a number. 



For example, the following are all valid names if the program radix is 
octal : 



12Q3 
li*2 

51F 



However, if the program radix is hexadecimal, the first two are valid 
names but the third is a hexadecimal number. 
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U. 2.1 Spaces in Names 



In addition to the above characters, MICR02 permits the use of spaces 
or tabs within a name. HI CR02 considers a space within a microword as 
a concept rather than as a particular sequence of characters. Thus, 
MICR02 considers the following names to be the same although the space 
in each case is made up of a different character sequence. 



A 


B 




A 


B 




A 


B 




A 




B 


A 


B 




A 




B 



However, the symbol shown above is not the same as the symbol AB, 
which does not have a space within it. 

As an example of the effective use of spaces in names, consider the 
following macro from the sample program givn in chapter 9. 

Tl <— PC + 1 

If this name is entered, by mistake, with two spaces between the 1 and 
he <, MICR02 still recognizes it as the same macro. That is, the 



I 



ol lowing are the s 



Tl < -- PC + 1 
Tl < — PC ♦ 1 



3.2.2 Upper and Lower Case 

MICR02 interprets upper and lower case letters as the same. Thus, the 
following symbols *r^ all treated as the same symbol. 

ABC 
ABc 

•be 



3.2.3 Length Limitation 

MICR02 imposes a limit of 128 characters on the length of a 
Further, because MICR02 is a line-oriented processor, a name must fit, 
with the other necessary information, on a line. 
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3 • 2 . *♦ Uniqueness of Names 

MICR02 names are classified as follows: 

field-names 
value-names 
macro-names 
express i on-names 

Field-names, macro-names, and exp; ess ion-names must be unique with 
respect to all other names in the same class for a given memory. 



Value-names, however, need be unique only with respect to other value 
names for the same field definition. For example, the following set 
of value names is valid: 

A/-<7:<»> 

A-0 

B-l 

C-2 
B/-<3:0> 

A-2 

B-l* 

C-6 

Since you must always qualify a value name by its associated 
field-name, MICR02 can easily distinguish the value-names. That is, 
MICR02 interprets A/B as 1 and B/B as k. 



A label is a value-name for the field designated as the address field. 
Only one field in a memory can be designated as an address field and 
thus all labels in a given memory must be unique. 



Communication between memories can be accomplished by value names. A 
discussion of field and value names in different memories is given in 
Section 8.1. The rule is that if the same field name is defined in 
more than one m em ory, then the value-names defined for that field in 
any memory *re known in all memories. Thus, if you define the address 
field to have the same name in several separate memories, then all the 
labels in those m e mories must be unique with respect to all other 
labels in the separate memories. 



DEFINING FIELDS AND VALUES Page 3-6 



^.3 QUALIFIERS 



Qualifiers are used to establish a default for a field, to identify 
the field as one that can contain a label, to designate a field to be 
used for a parity bit, and to associate the setting of a field with 
the condition of other fields within the microword. The qualifiers 
are given in the following list: 

.DEFAULT ■ default-expression 

.ADDRESS 

.NEXTADDRESS 

.FLOATEPARITY 

.FLOATOPARITY 

.VALIDITY - validity-expression 



The following sections consider each of these qualifiers. 



3.3.1 The .DEFAULT Oual if ier 

The .DEFAULT qualifier specifies a value that MICR02 can use for 
field when you do not explicity set the field. 



I 



s you will see in Chapter fe, "Microinstructions," MICR02 forms a 
microword by starting with a word of bits each of which has a value of 
zero and a status of unset . Then, it translates field-settings given 
in the microinstruction to set the bits of the fields. When MICR02 
processes a field-setting, it changes all the bits of the field. It 
changes the value of each bit to a zero or one and the status of each 
bit from unset to set. MICR02 uses the default for a field if, and 
only if, no bit of the field is explicitly set. 



* a bit of a field is set as a result of an overlapping field being 
set, then the default for that field is not applied. 



If you do not set a field and do not indicate a default, then MICR02 
does not set that field and the bits continue to have the value zero 
and the status unset. 



The default-value is an expression. The rules for forming a MICR02 
expression are given in section k.\. The simplest form of an 
expression is a number. The following examples use only numbers for 
default-values. The use of expressions in defaults is illustrated in 
the sample program in Chapter 9. 
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3.3.1 - 1 An Example - To illustrate the use of the .DEFAULT qualifier, 
suppose we add some defaults to the fields defined in Section 3.1 as 
fol lows: 

.RTOL 

.OCTAL 

A/-<7:1»>, .DEFAULT-1 

B/-<3:0>,.DEFAULT-2 

C/-<7:3>,.DEFAULT«3 

D/-<2> 

E/-<1:0> 



Now consider the cases given in the following sections 



3- 3-1- 2 Case 1; Simple Default - Suppose we set only the A field in 
the microinstruction, as follows: 

A/2 

MICR02 first sets the bits in field A to the value 2. Then it 
considers the defaults in the order specified. It ignores the default 
for field A, since that field is explicitly set. It uses the default 
for field B since the status of every bit in that field is unset. 

7 6 5 *♦ 3 2 10 
+ K 

;o 1 1 0; 



After HICR02 uses the default to set the bits in field B, all bits are 
set and MICR02 does not consider any 'urther defaults. 



3- 3- 1-3 Case 2: Defaults and Overlapping Fields - If more than one 
default can be i ed to a sequence of bits, AICR02 chooses the 
default specified first in the microprogram. 



In the example given above, the fields A and C overlap and both fields 
have defaults. Suppose we set only the D field, as follows: 

D/l 

HICR02 sets the bit in field D to 1. HICR02 then applies the first 
default in the microprogram, the default value for A, to set bits 7 
through 4. MICR02 does not use the default for B because a bit in 
that field is set (bit 2) or the default for C because bits 7 through 
*» are set by the default value for A. 
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P. 3. 2 The .ADDRESS and .NEXTAUDRESS Qualifiers 

MICR02 requires that the jump field be identified by either an 
.ADDRESS or .NEXTADDRESS qualifier. A field defined with the .ADDRESS 
or .NEXTADDRESS qualifier can be set to the value of any label in the 
program. 



In addition to designating the associated field as a jump field, the 
.NEXTADDRESS qualifier specifies that the default for the field is the 
value of the address associated with the next microinstruction given 
in the program. 

Since the .NEXTADDRESS qualifier serves the dual purpose of 
identifying a field as an address field and supplying the default for 
that field, you must not use a .DEFAULT qualifier in combination with 
a .NEXTADDRESS field. 



One field and only one field in a memory can be designated as the jump 
field by the use of either the .ADDRESS or the .NEXTADDRESS qualifier. 



To illustrate the .NEXTADDRESS qualifier, suppose we add definitions 
for fields X and J to the field definitions given for the discussion 
f the .DEFAULT qualifier, as follows: 



t 



• RTOL 

.OCTAL 

A/«<7:J»>,.DEFAULT«1 

B/-<3:0>,.DEFAULT-2 

C/-<7:3>..DEFAULT»3 

D/-<2> 

E/-<1:0> 

X/-<15:8> 

J/-<23: 16>, .NEXTADDRESS 



The definitions describe the following microword: 



2 2 1 

32 1098765M2 l 098765432 l 



+ 



< j > 



< X > 



A j B 
C jDj E 



(. + 



DEFINING FIELDS AND VALUES Page 3-9 



Suppose the following sequence of microinstructions are given for the 
above definitions: 

0201: 

LI: A/1.B/1.J/L2 
0203: 

L2: A/2.B/1 
020i*: 

L3: A/3.B/3 
0206: 

LA: AA.BA 

The field J, which has the .NEXTADDRESS qualifier, is set explicitly 
in the first microinstruction (LI) to the label L2, which is the octal 
value 0203- In the other microinstructions, J is not set and thus 
MICR02 provides the default setting of the address of the next 
microinstruction. In the microinstruction labelled L2, J is set to 
the octal value 020**. Similarly, in the microinstruction labelled L3, 
J is set to 0206 (octal). 



The fields X and J each contain eight bits. The field J, having the 
.NEXTADDRESS qualifier, can be set to the value of a label; the X 
field, however, can only be set to a value. For example, suppose the 
label LI is allocated to the value 0212. We can set both X and J to 
the value 0212, as follows: 

X/212.J/L1 
Or we can wr i te: 

X/212, J/212 
But we cannot set the field X to the label LI. 



3-3-3 The .FLOATOPARITY and .FLOATEPARITY qualifiers 

The parity qual if iers, .FLOATEPARITY and .FLOATOPARITY, designate a 
field for MICR02 to search to find an unset bit to use as a parity 
bit. When you add this qualifier to a field definition, MICR02 
examines the field after all the values are set and the defaults are 
applied and uses the first unset bit it finds in that field, searching 
from left to right, to adjust the parity to even or odd. If you 
specify the .FLOATEPARITY, J1ICR02 adjusts the parity to even parity if 
it is not already even; if you specify .FLOATOPARITY, HICR02 adjusts 
to odd parity. Even parity means that the number of l's in the word 
is an even number. Odd parity means that the number of l's is an odd 
number. 
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puppose we add the following field definition to the set we have been 
developing: 



P/-<23 : 0> , . F LOATOPAR I TY 
The microword now looks as follows: 



2 2 1 

32 1098765i»32 1098765^32 10 



+ — 

! <• 
+ — 

1 



1 
+- 



— k 
•> i 

Y 



A ! B J 
C !D| E J 



J > 




Suppose we set field E to 1 , X to the octal value 202, and J to the 
value of I.AB3 in a microinstruction as follows: 

LAB2: E/1.X/202.J/LAB3 

Assuming LAB3 is the octal value 213. the microword contains the bits 
shown in the following diagram before the parity is adjusted: 

2 2 1 

321098765 J »321098765i»3210 
+ + 



10 10 1 1 



1 1 0J0 1 



1 



In the above microword, fields J, X, and E are set explicitly and 
field A is set by default. That is, all bits except bits 3 and 2 are 
set either explicitly or by default. The .FL0AT0PARITY qualifier 
associated with the field P causes MICR02 to search from left to right 
within that field (that is starting from bit 23) to find the first 
unset bit if the parity of the word is not odd. The first unset bit 
is bit 3 and MICR02 sets that bit to 1 to turn the parity of the word 
to odd pari ty. 
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Suppose we do not set X. That is, we write: 

LAB2: E/1.J/LAB3 
The microword before parity is: 



2 2 1 

32l098765'»321098765 i »32lO 
+ + 



10 10 1 1 



1 



1 



When MICR02 searches the field P from left to right, the first unset 
bit it finds is bit 15. Therefore, MICR02 sets bit 15 to 1 to adjust 
the parity to odd parity. 



3-3- 1 * The .VALIDITY Qua) if ier 

The .VALIDITY qualifier lets you make assertions about the conditions 
under which a field can be legally set. The .VALIDITY qualifier 
associates a validity expression with a field. If the validity 
expression is not satisfied when the field is set in a microword, 
MICR02 produces a warning message. 



The .VALIDITY qualifier and 
subject, which is described 



use of the validity expressions is a deep 
in detail in Chapter k. 



}.U VALUE NAMES 

A value-name is a 
particular field. 



name associated with a particular value of a 



A value-name is defined by a value-definition following the field 
definition. A value-definition consists of the value-name followed by 
the separator '■' followed by the value to be equated with that name 
when the name is used to set the field. In addition, a 
value-definition can specify one or two values, which are added into 
two separate counters, . TIME 1 and .TIME2, when the field value name is 
used to set the field. The value-definition can also have its own 
.VALIDITY expression. Thus, the form is: 



va 1 ue-name-va 1 ue , t 1 -va 1 ue , t2-va 1 ue, . VAL I D I TY-exp 
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Jhe tl-value, t2-value, and .VALIDITY expression are all optional. In 
the simplest case, a value name is associated with a value for a field 
as fol lows: 

A/-<7:J»>,.DEFAULT«1 
AO-0 
Al-1 

A4=<4 



In the above example, three value-names are defined for field A, 
namely AO, Al, and Alt. These names can be used in a microinstruction 
to set A as follows: 

LAB: A/AT 

Normally field-names and field-value names have more mnemonic content 
than the ones given above. For example, consider the following 
excerpt from the sample program given in chapter 9: 

SETCC/-<15>,.default«0 

NOP =0 ;Do nothing with condition codes 

SET «= 1 ;Set condition codes according 

; to IR value and status of ALU. 



$.1*.} Counter Values 

If the value-definition includes a tl-value, then that value is added 
into the counter .TIME1. If the field-value-definition includes a 
t2-value, then that value is added into .TIME2. The resulting values 
of .TiMEl and .TIME2 can then be used in validity expressions. 
Chapter k describes the use of these counters in validity expressions. 

For example, suppose we associate a tl-value with the value-name Al, a 
t2-value with the value-name Bl, and both a tl and t2-value with the 
value-name Alt, as follows: 

Al - <7:4>,.DEFAULT-1 

AO « 

Al - 1,3 

Alt - It, 2, 6 
B - <3.:0>,.DEFAULT-2 

BO - 

Bl « 1,,8 

If we use the value-name Al in a microinstruction, the counter .TIME1 
is increased by the associated tl-value, 3* If we use both Alt and Bl, 
£hen .Tl ME 1 is increased by 2 (for Alt) and .TIME2 is increased by 6 
pfor A4) and 8 (for Bl) . Chapter it describes the use of these 
counters in validity expressions. 



CHAPTER 4 
EXPRESSIONS AND VALIDITY CHECKING 



Validity expressions allow the addition of semantic meaning to a 
definition language by indicating the conditions under which it is 
invalid to use a particular field or value name. 

When a field or value name that has an associated validity is used in 
a microinstruction, MICR02 evaluates the expression. If the value of 
the expression is 1 (true), then MICR02 takes no action. However, if 
the value of the expression is (false), MICR02 issues a warning 
message. In practice, any value that is not 1 is considered to be a 
false value. 



The following sections consider expressions in general and then the 
ways in which a validity expression can be associated with a field or 
value narj. 



l».l EXPRESSIONS 

An expression in MICR02 is enclosed in angle brackets. An expression 
can be any of the following: 

A number 

An expression name 

A function cal I 

A field va 1 ue name 

A field contents indicator 

A predefined symbol 

An expression can occupy more than one line as long as the last 
character of each line to be continued is a comma character. For an 
example of a continued expression, see Section 4.1.7. 

The following sections consider each of these cases in detail. 
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► 



.1.1 Numbers 



MICR02 recognizes integers or decimal numbers. An integer is 
interpreted according to the program radix. A number with a decimal 
point is always interpreted as a decimal number. You set the program 
radix by adding either the .OCTAL or the .HEXADECIMAL keyword to your 
program. If you do not give a program radix, then an octal radix is 
assumed. 

Some special cases occur in the interpretation of integers, as 
f ol lows: 

o If the program radix is octal and an integer contains an 8 or 
a 9 digit, then the number is interpreted as a decimal 
number. 

o MICR02 interprets a character sequence beginning with a 
letter as a name. Thus, if the program radix is hexadecimal 
and the first digit in a number is a letter, then you must 
write the integer with an initial zero to prevent its being 
interpreted as a name. For example: 

F12 interpreted as a name 

OF 12 interpreted as an integer 



4.1.2 Express i on-Names 

t . expression-name is defined by the .SET keyword as follows: 

. SET/express ion-name ■ <expression> 
For example: 

.SET/SWITCH1 - <1> 

MICR02 associates the value 1 with the expression-name SWITCH1. You 
can use the expression-name in subsequent expressions. For example: 

.SET/SWITCH2 - <SWITCH1> 



The .SET keyword- line is described in detail in connection with 
conditional assembly capability in Section 10.2. 
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J+.1.3 Function Calls 

MICR02 provides functions for comparison, arithmetic, and Boolean 
operations. Also, MICR02 provides functions to detect parity, shift, 
and select a case from a set of choices. 



The functions are given in the following table: 
Function Va 1 ue 



Compar ison 
,EQL[opl ,op2, 
.NEQ[opl ,op2, . 
.GTR[opl ,op2, . 
.GEQ[opl ,op2, . 
.LSS[opl ,op2, . 
.LEQ[opl ,op2, . 



Ar 
.MAX [op 1 ,op2, . 
.MIN[opl ,op2, . 
.SUM[opl ,op2, . 
.PR0D[opl,op2, 
.DIFF[opl,op2] 
.QU0T[opl,op2] 
.MOD [op 1 ,op2] 



metic 



op2<>op3 and 



i f opl=op2". . . 
if opl<>op2 and 
i f opl>op2>. . . 
if opl>»op2>=. . , 
i f opl<op2<. . . 
if opl<«op2<'=. . 



Value of largest operand 

Value of smallest operand 

opl+op2+. . . 

opl*op2*. . . 

opl-op2 

opl/op2 (truncated) 

remainder of opl/op2 



Boolean 



NOT [op] 
.AND[opl,...] 
.0R[opl , . . .] 
,X0R[opl,...] 
.NAND[opl,...] 
,N0R[opl , . . .] 
. EQV[op, . . .] 



Boolean complement of op 
Boolean 'and' of operands 
Be ^an 'or' of operands 
Boolean 'xor' or operands 
Boolean complement of the 
Boolean complement of the 
Boolean complement of the 



Mi seel laneous 



'and' 

'or' 

'xor 1 



.PARITY[opl,op2,...] 
,SHIFT[opl,op2] 

.CASE[opl]0F[op2,...] 

.SELECT[{opl,op2,}...] 



If operands contain an even 

number of l's, then 1 else 
If op2 is positive, then shift opl 

left op2 places else shift 

opl right op2 places 
The (opl-th + 1) operand of the list. 

That is, if opl is 0, the first op2 is 

used. Up to 32 choices can be given. 
The first op2 for which 

opl is true 



The operands of a function can be expressions. Thus, you can 
construct very complex expressions. Some examples of expressions are 
given in Section it.'. 7. 
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l.l.*t Value-names 



Value-names are the names that you associate with a value for a given 
field, as described in Section $.k. 



Since a value-name is only defined for a specific field, it must be 
qualified by the field-name when you use it in an expression as 
fol lows: 

f i eld-name/value-name 



For example, suppose we define the following field- and value-names: 

A/-<7:i*> 
AO-0 
Al-1 
A4-i» 

Then, the value-names can be used in an expression as follows: 

<.EQL[<A/A1>,<X>]> 
The above expression is equivalent to: 

<.EQL[1,<X>]> 
In the above expressions, X is an expression name. 



i» . 1 . 5 Field Contents Indicators 

The contents of a field can be designated in an expression by giving 
the field-name followed by a slash. For example, to find out if the 
current contents of field B contains the -alue k, you write the 
following expression: 

.EQL[<B/>,<4>] 



For some uses of field contents indicators, see Section k.2 on "The 
•VALIDITY qua! if ier." 
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4.1.6 Predefined Symbol Names 

Three symbols are predefined in MICR02, as follows: 

Symbol Mean i nq 

The address of the current 
microinstruction 

.TlftEl The value of the counter associated 

with tl -values. 

.TIME2 The value of the counter associated 

with t2-values. 



The .TlftEl and .TIHE2 predefined symbols are described in section 3.J4 
in connection with the definition of value-names. 



As an example of the use of these symbols, consider the following 
example: 

A/«<7:4>,. DEFAULT -2 

AO-0,10,10 

Al-1.10 

Ai»-i»,10 
B/-<3:0>,. DEFAULT -2 

BO-O.5,8 

Bl-1,2,12 
X/-<15:8>. ADDRESS,. VALIDITY -<. LSS[. TlftEl , H»]> 

The definition of AO specifies that its use to set field A in a 
microinstruction adds 10 to the .TlftEl counter and 10 to the .TIftE2 
counter; the definition of A1 specifies that its use adds 10 to the 
• TlftE2 counter; and so on. 



Now suppose we have the following microinstructions: 
LABI: A/A0.B/B0.X/L2 
LAB2: B/BI.X/L3 



After all the fields are set in the first microinstruction, labelled 
LABI, the counter .TlftEl contains the value 15 and the counter .TIME2 
contains the value 18. When ftlCR02 evaluates the validity expression 
for the field X, it finds that the value of .TlftEl is greater than H 
and thus the expression is false. ftlCR02, therefore, reports an 
error. 

After all the fields are set in the second microinstruction, .TlftEl 
contains 2 and .TIftE2 contains 12. The validity expression is true 
and no error is reported. 
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p. 1 .7 Ex amp 



les 



Now let's consider some examples of expressions. Suppose we want to 
produce a true result if the contents of field A and the contents of 
field B both equal 1. That is, if the following is true: 

<A/>-<B/>-l 

We use the .EQL function a follows: 

.EQL[<A/>.<B/>.1] 

To find out if the contents of field A and field B equal 1 and the 
contents of field C and field D do not equal 1, we use the .EQL, .NEQ, 
and .AND functions as follows: 

.AND[<.EQL[<A/>.<B/>,l]>,<.NEQ[<C/l>,l.<D/>]>3 
To perform the computation: 

<A/>+<B/>+2*<C/> 
We use the .ADD and .PROD functions as follows: 

. ADD [<A/> . <B/> , < . PROD [2 , <C/>] >] 

To choose a value based on the value of the predefined name .TIHE1, we 
use the .CASE function as follows: 

.CASE[<.TI«E1>T0F[10,2.6,21] 

If the value of .TlftEl is 0. then the function value is 10. If the 
value of .TIME1 is 1, then the function value is 2. And so on. If 
the value of .TINE! is greater than 3# an error is reported. 

If the length of the expression exceeds a line or if formatting the 
expression will aid its readability, we can continue the expression on 
several lines. 

For example, we can write: 

OPCODE/xl5:8>..VALIDITY-<CASE[VAL]0F[ADD. 

SUB. 
miLT, 
DIV] 



k.2 VALIDITY EXPRESSIONS 

The .VALIDITY qualifier associates an expression with a field- or 
)alue-name. The form of the .VALIDITY qualifier is: 

.VALIDITY - expression 
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MICR02 evaluates validity expressions after all the fields explicitly 
given in the Microinstruction have been set and after any defaults are 
applied. If the value of that expression is true (1), then MICR02 
takes no action. However, if the value of that expression is false 
(0), then MICR02 prints a warning message. 



*.2.1 Associating A Validity Expression With A Field 

Suppose we assign a .VALIDITY qualifier to field A, in the following 
set of field definitions, as follows: 

.RTOL 

.OCTAL 

A/-<7:'»>..DEFAULT-l,.VALIDITY-<.EQL[<B/>,3]> 

B/-<3:0>,.DEFAULT-2 

The validity expression in the above example asserts that setting 
field A to a value is legal only if the value of field B is 3- If 
field A is set when field B contains any other value, an error message 
is reported. Let's consider some cases: 



Microinstruction Wicroword Comment 

A/l.B/3 00010011 B is explicitly set to 3. 

thus setting A is valid. 

A/1 00010010 B is set to 2 by default 

thus setting A is invalid 
and a warning message is 
reported. 

A/l.B/2 00010010 B is explicitly set to 2, 

thus setting A is invalid 
and a warning message is 
reported. 

B/l 00010001 A is not explicitly set, 

thus the validity expression 
is not evaluated. 



*».2.2 Associating a Validity expression with a Value-Name 

A value-name definition can contain a validity expression. Suppose we 
add a validity expression to the set of field definitions giver, above. 

A/-<7 ;*»>.- DEFAULT -2 

A0-0,10,10 

A1-1,0,10,.VALIDITY-<.EQL[B/,0]> 

A4-4.12 
B/-<3:0>.. DEFAULT -2 

BO-0,5,8 

Bl-1.2.12 



X/-<15:8>. ADDRESS,. VALI0ITY-<.LSS[.TIME1 , 14]> 
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k 



hen consider the following cases: 



Microinstruction Resul t 

A/A1.B/B0 Validity expression associated with 
value-name Al is true because 
field B contains 0. 

A/A1 Validity expression associated 

with Al is false because field 
B contains the default value 2. 

A/AO.X/2 Validity expression associated 
with field name X is true 
because .TIME1 contains 10, 
which is less than 14. 

A/A4.B/B0 Validity expression associated 
with X is false because 
.TlrtEl contains 17. 



As another example, suppose we add a validity expression to both a 
field definition and a value name definition as follows: 



A/-<7;l»>,. DEFAULT -2, .VALI DITY-<.LSS[.TI WE 1 , .TI«E2]> 

A0-0.10,10 

A1-l,0,10,.VALIDITY-<.EQL[B/,0]> 

Ai»-i»,10 
B/-<3:0>,. DEFAULT -2 

BO-O.5,8 

Bl-1,2.12 

B2-2.20 
X/-<15:8>. ADDRESS,. VALIDITY-<.LSS[.TI«E1,H]> 



Now consider the following cases: 



Microinstruction Resul t 

LA35: A/A1.B/B0 .TIME1 contains 5 and .TIKE2 contains 18. 

Thus both validity checks are satisfied 

LAB6: A/A1.B/B1 The validity expression associated with the 

field value name Al is false; therefore, an 
error is reported 

LAB7: A/A1.B/B2 Neither validity check is satisfied; 

therefore, two errors are reported 



CHAPTER 5 
DEFINING MACROS 



The macro capability of MICR02 permits the definition of a 
representation for a microprogram at a higher level than the basic 
field-value pairs. Once the fields of your microword are defined, a 
set of macros that set groups of fields appropriately for certain 
operations can be specified. 



To define a macro, you write the macro-name followed by a quoted 
string that contains the macro-body. When you use the macro-name in a 
microinstruction, then MICR02 replaces the name by the macro-body. 



The simplest case of a macro definitior. is one that does not contain 
any parameters. For example: 

HI "A/AO.B/BO" 

Writing the name Ml in a microinstruction is equivalent to writing the 
pair of field settings. That is, the following are equivalent: 

LI: Ml LI: A/AO.B/BO 



The following sections describe the process of defining and using 
macros. 
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I 



.1 THE MACRO-NAME 



Macro-names are formed using the set of characters given in Section 
3.2. In addition to these characters, MICR02 recognizes square 
bracket pairs and commas in macro-names as indicators of the number 
and position of the macro parameters. 



A macro with one parameter contains an empty square bracket pair in a 
macro-name. For example, each of the following macro-names requires 
one parameter . 



ABCD 
A[]BC 
[]ABC 



A macro with two parameters contains either two square bracket pairs 
or a comma within a single square bracket pair, as follows: 

ABC[]D 
AB[]C[] 

□ ABCD 
ABC[,] 
A[.]BC 
C.]ABC 

The only limitation on the number of parameters in a macro-name is the 
length of the line. The macro-call with all its arguments must f i t on 
one 1 i ne . 



The number and position of parameters in a macro-name are an integral 
part of the name. Thus the macro-names given above all define 
different macros. That is, the macro ABCDD is not the same as 
ABC[,] and so on. 



5.2 THE MACRO-BODY 

The macro-body consists of any combination of field-settings and 
macro-calls separated by commas. When a macro is used in a 
microinstruction, MICR02 replaces the macro-name by the macro-body 
associated with that name. Consider a macro defined in the sample 
program in chapter 9: 

Pop Stack "MEMFNC/STKRD, ALU/A, CLKn/YES" 

Writing the macro-call Pop Stack in a microword is equivalent to 

Iriting the three field settings given in the macro-body. In Chapter 
, we will see how the definition of a macro language facilitates the 
process of writing and understanding a microprogram. 
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5.2.1 Continuing a Macro Definition 

Macro definitions can be continued to the next line. If the last 
non-blank character of a line in the macro-body is a "." (comma) 
character, MICR02 assumes that the next line is a continuation line. 
For example, the above macro could have been defined using three lines 
as fol lows: 

Pop Stack "MEMFNC/STKRD, 
ALU/A, 
CLKT1/YES" 



5-2.2 Nested Macro Definitions 

Since a macro-body can contain a macro-call, any number of macro 
languages can be constructed, one upon another. You can, for example, 
start with a primitive set of macro definitions. Then using these 
primitive definitions, add another, more sophisticated, level of 
macros, and so on. 



5-3 THE MACRO-CALL 

The macro-call is the macro-name with actuals filling the indicated 
parameter positions. 

The macro-call for a macro without parameters is the macro-name 
itself. The macro-call for a macro with parameters includes the 
actuals within the square brackets of the macro name. 



MICR02 first replaces a macro-call by the macro-body. If the 
macro-body contains macro-calls, MICR02 replaces those calls. MICR02 
continues in this way until the microinstruction contains only 
field-settings. 



To illustrate the way in which MICR02 replaces macro-calls, suppose we 
define the following three macros: 

Ml "A/A0.M2.B/B0" 
M2 "C/C0.M3" 
M3 "D/DO" 

Then we use the macro-name Ml in a microinstruction: 

LI: X/L2.M1 

MICR02 first replaces the macro-name Ml by its associated macro-body, 
as fol lows: 

LI: X/L2.A/A0.M2.B/B0 
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P'hen MICR02 replaces M2 by its associated macro-body: 

LI: X/L2.A/AO.C/CO.M3.B/BO 
Then MICR02 replaces M3: 

LI: X/L2,A/A0,C/C0.D/D0.B/B0 



The above microinstruction consists of only field settings and so no 
further replacement can occur. 



5- 3-1 Parameters 

Square brackets and commas indicate parameters in the macro-name. The 
character "6" followed by a decimal integer in the macro-body 
indicates the position of the parameter in the macro-body. This 
character pair is called a parameter-designator. 

The decimal integer in the parameter-designator refers to the 
position, numbering from left to right, of the parameter in the name. 

kf you use only one parameter, then you designate it by '@1 ' in the 
acro-body. 

Suppose we define the following macro: 

M4C] "A/A0,B/ei" 



Then we use it in the following microinstructions: 
LI: C/CO,Mi»r.BO] 
L2: M<t[Bl] 

MICR02 expands the macro call as follows: 
LI: C/CO.A/AO.B/BO 
L2: A/A0.B/B1 



If you use several parameters, then you designate the leftmost 
parameter in the macro-name as '§1', the one to the right of that as 
'82' , and so on. 



Suppose we define a macro with four parameters: 
H5C.DABDCD "A/ei.B/e2,C/§3.0/ei4 
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Then we use it as followr: 

LI: M5[Al,Bl]AB[C2jC[n3] 

MICR02 replaces the macro by its associated macro-body: 
LI: A/A1,B/Bl,C/C2,D/03 

5-3.2 Hu 1 * ' ^ i e Use Of Parameter Designator 

You can use a parameter designator more than once in a macro body. 
For example, to set the fields A, B, and C to the same value, you can 
specify a macro that has that value as a parameter: 

SET ABC[] "A/ei.B/ei.C/ei" 

Then to set all the fields to zero, you write: 
SET ABCfO] 

5.3-3 Parameter Designators as Field-Values or Macro-Calls 



Parameter-designators can be used within the macro-body as either 
field-values or macro-calls. If the parameter-designator is used as a 
field value, then the corresponding parameter must be either a value 
or a field-value-name. Similarly, a parameter-designator used as a 
macro call must be filled by a parameter that is a macro-call. 



For example, consider the following macro-definition: 
M5[.] "A/ei.e2" 

When the above macro is called, the first parameter must be a value or 
field-value-name and the second parameter a macro-call. Suppose we 
have the following additional macro-definitions: 

M6 "B/Bl" 

M7[]+[] "C/ei.D/§2" 

The following calls on M5 produce the indicated results: 

Cal 1 Expansion 

M5C1.M63 A/A1.B/B1 

r15D.n7[Cl] + [D2]] A/Al ,C/C1 ,D/D1 
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p.3«*» Too Many or Too Few Parameters 



As described in Section 5.1, MICR02 considers the position and the 
number of the parameters as part of the name. If you supply too many 
or too few arguments in a macro-call, MICR02 detects the error, unless 
you have defined another macro that, by coincidence, the macro-call 
satisf ies. 



Suppose you define the following macro: 
M2[,] "A/ei,B/e2,D/l" 



Then, if you call it with the proper number of arguments (2), you get 
the valid replacement, as follows: 



M2[A1,B1] is replaced by A/Al ,B/B1 ,D/1 



However, suppose you mistakenly call the macro with three parameters, 
as fol lows: 



M2[A1,B1,1] 



I 



I CR02 does not recognize the above as a valid call and produces an 
error message. 



However, suppose you define another macro with three parameters, so 
that you have: 



M2[,] "A/ei,B/e2,D/l" 

M2[,,3 "A/ei,D/e2,E/e3' 



Then, the following calls are valid: 

Cal 1 Expansi on 

M2[A1,B1] A/M.B/B1.D/1 

M2[A1,1,2] A/ l.D/l.E/2 



When you use names that are the same except for the number of macros, 
you lose the error checking performed by MICR02. Such naming is, 
therefore, not recommended. 



CHAPTER 6 
MICROINSTRUCTIONS 



The microinstructions describe the processing to be performed by the 
microprogram. These microinstructions are expressed in terms of the 
field and macro-names defined. 



For each microinstruction, MICR02 translates names into the 
appropriate sequence of bits and creates the associated microword. 



The following sections consider the microinstruction and the formation 
of the microword. 



6.1 THE MICROINSTRUCTION 

The microinstruction contains the information MICR02 needs to set the 
bits of the microword. 



Both the address and label can be omitted. 

A microinstruction begins with an absolute address assignment, one or 
more labels, or both. Following this optional information, a sequence 
of field-settings and/or macro-calls is given separated bv commas. 



That is, the form of the microinstruction is: 

address: 
{ label: } 

{ f ield-setting } , . . . 
{ macro-cal 1 } 



A microinstruction is different from all other MICR02 language 
constructs because it can occupy several lines. 
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% 



1 . 1 Continuing a Microinstruction 



If a microinstruction occupies more than one line, the separator 
character ',' must be as the last non-blank character of all lines 
except the last line. For purposes of this discussion, the end of the 
line is assumed to be either the ';' character, which begins a 
comment, or the actual end of lii... Thus the last non-blank character 
of a line means the last non-blank before the ';' or end of line 



When MICR02 finds a comma as the last non-blank character of a line, 
it continues the microinstruction using the information on the next 
line. When MICR02 finds a line that does not end with a comma, it 
concludes the microinstruction and produces the microword. 



Suppose we write the following portion of a microprogram: 



A/A0.B/B1, 

C/C2, 

J/Ll 



MICR02 interprets the above as a single microinstruction that sets 
fields A, B, C, and J. 



However, suppose we omit the terminating commas: 

A/A0.B/B1 

C/C2 

J/Ll 



MICR02 interprets the above as three microinstructions and produces a 
microword for each. 



6.1.2 Allocating a Microinstruction 

The following microinstruction contains an address (612) and two 
label s (R and Q) : 

0612: 
R: 

Q: 

A/A1.B/B1 



MICR02 produces the microword and, allocates it to word 612, and 
associates the specified absolute octal value 612 with the labels R 
and Q. 
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Both the address and label are optional. Suppose you write: 

R: 

A/A1.B/B1 



For this case, MICR02 produces the same microword but chooses the 
allocation for the word and associates that address with the label R. 



When MICR02 processes the microinstruction, it creates a microword and 
assigns that microword to an address. The following sections consider 
these two activities in detail. 



6.2 THE MICROWORD 

MICR02 creates a microword in the following way: 

1. MICR02 clears the counters .TIME1 and .TIME2 and begins with 
a word of the specified length in which each bit has a value 
of zero and a status of unset. 

2. MICR02 then fills in all the fields that are explicitly set 
in the microinstruction. 

3. Then, MICR02 sets any fields that have an associated default 
and that contain only unset bits. 

J*. Then, MICR02 evaluates any VALIDITY expressions. 

5. Finally, MICR02 performs any parity adjustment indicated. 

Let's look at the creation of a microword. First, consider the source 
program: 

.TITLE "TEST" 

.OCTAL 

.RTOL 

•WIDTH/2^ 

.REGION/0200,0277 

A/«<7:1»>,. DEFAULT -2 

AO-0,10,10 

A1-1,10,.VALIDITY«<.EQL[<.TIME1>,<.TIME2>]> 

Ai»-4,10 
B/-<3:0>,. DEFAULT -2 

BO-0,5.8 

Bl-1,2,12 
X/-<15:8>. ADDRESS,. VAL I DITY-<.LSS[<. TIME i>,Ui]> 
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J/-<23: 16>. .NEXTADDRESS 
P/-<23:0>, .FLOATEPARITY 

Ml[] "Al/ei" 

M2[] + R "k/%\,B/Q2" 

•TOC "MICROCODE" 

A: M1[A1] 

Now, consider the creation of the microword for the microinstruction 
labelled A. 



MICR02 initializes the counters .TIME1 and .TIME2 and begins 
with a word consisting of 2k unset (zero) bits. 



22221111111111 
321098765^321098765^3210 




2. MICR02 expands all macros until the source consists of a set 
of field settings and then sets those fields. 

Expanding the microinstruction labelled A above produces the 
following field setting: 

A: A/A1 

MICR02 then sets the field A (bits 7 through k) to the value 
Al (1) . The microword now contains the following values: 



22221111111111 
321098765*»321098765'»3210 




/!\ 

1 
1 

A 



In setting field A to the value designated by Al, MICR02 adds 
the counter value: associated with Al into the counters 
.TIHE1 and .TIAE2. After setting field Al, the counter 
.TIME1 contains the value 10 and the counter .TIME2 still 
contains 0. 
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Next MICR02 applies defaults. Fields A and B have defaults. 
Field A is explicitly set, but no bit of field B is set, so 
MICR02 sets field B to its default value (2). 

The field, J, designated as the next address is not 

explicitly set, so MICR02 sets it to the value of the next 

microinstruction. Suppose the next microinstruction address 
is 0212 (octal) . 

The microword now contains the following bits: 



22221111111111 

32 1 98 7 ^"t 32 1 09 8 76^ 3 2 1 

+ 1 



i o o o i o i o; 



»o o 1 |0 1 0! 



H H 



Next, MICR02 evaluates validity expressions. The definitions 
associate validity expressions with value-name Al and field 
X. Field X is not set in this microinstruction, so the 
validity expression associated with X is not evaluated. 

A warning message is produced because the validity 
expressions for the value-name Al is not satisfied since the 
value of .TIME1 is 10 and the value of .TIME2 is 0. 



Finally, MICR02 aJjustT the parity in any fields designated 
as FL0AT0PARITY or FL0ATEPARITY. Field P is designated as a 
field to be adjusted for ?"en parity. 

The word at this point c... . odd parity, so MICR02 searches 

from left to right in the field P to find the first unset 

bit, which is bit '5- MICR02 sets that b\* to 1 to adjust to 
even parity. 

The microword now contains the fo's lowing bits: 



22221111111111 

32 10987651*321098765^3210 



1000 10 1 OM 



|0 1 JO 1 0] 



Bits \K through 8 contain the value and have the status 
unset. 



CHAPTER 7 
ALLOCATION 



The address space for the microprogram is established by the .REGION 
keyword and the method of allocation by the .RA DOM and .SEQUENTIAL 
keywords. 



7-1 DEFINING THE ADDRESS SPACE 

The .REGION keyword determines the address-space. The .REGION keyword 
is followed by one or more pairs of address limits, as follows: 

. REG I ON/ 1 ow-bound . h i gh-bound . . . 



Low-bound and high-bound are expressions whose values are interpreted 
according to the program radix. 



For example, if you want your microprogram to be allocated in the 
address space that begins with the address 0200 and ends with the 
address 0277. you specify the following region. 

.REGION/0200,0277 



If you want your microprogram to be allocated in an address space that 
consists of a set of disjoint address ranges, you specify the address 
limits for each range. For example: 

. REG I ON/0 302. 0320/OifOO, 0461/0200, 0207 



You can specify any number of .REGION keywords. MICR02 allocates the 
microinstructions following a .REGION up to the next .REGION keyword 
(or the end of memory) in the specified address space. 



If you do not give a .REGION at the beginning of your memory, MICR02 
assumes that the address space begins at and ends at MAXPC, the 
highest available address for the given architecture. 
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Consider the following program fragment: 

+ h 

.TITLE 



.REGION/0200.0277 



+ 



.REGION/0400,0500 



The microprogram above has three logical parts from the allocation 
point-of-view: Part A resides in the address range OOOO-MAXPC; part 
B resides in the range 0200-0277; part C in the range 0400-0500. 



If MICR02 uses all the available addresses in 0400-0500, it can not in 
this case use any addresses left in the range 0200-0277 • 



Now consider a microprogram that has a single REGION keyword: 




} 
} 

} A 
} 

} 
} 
} 
} B 

} 
} 



This microprogram has two logical parts. Part A resides in address 
range 0000-MAXPC and Part B resides in address range 0200-0277 and 
0400-0500. MICR02 does not begin allocating in the address range 
0400-0500 until it has used all the available addresses in the range 
0200-0277. In the previous example, MICR02 starts allocating in the 
range 0400-0500 when it finds the REGION keyword that begins logical 
part C. 
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|llCR02 considers each range specified individually, even though two 
ranges May be adjacent or overlapping. For example, suppose you 
define the following address space: 

.REGION/0100,0177/0200,0277 

HICR02 treats the above as specifying an address space that consists 
of two separate ranges. 



7.2 SPECIFYING THE WETHQO OF ALLOCATION 

Within the specified address space, you can select either sequential 
or random allocation. 



7.2.1 Sequent i a 1 All ocat i on 

In sequential mode, MICR02 allocates a microinstruction by taking the 
address of the previous microinstruction and adding 1. 



MICR02 begins allocating with the first address in the address space 
Mefined by the .REGION keyword and continues incrementing until it 
reaches either an absolute address assignment or the end of the 
address range. 



When it reaches an absolute address, MICR02 uses that address for the 
associated microinstruction and as the new base for incrementation. 



When MICR02 uses the last instruction in an address-range, it chooses 
the first address in the next address-range for the next 
microinstruction. After MICR02 uses the last address in the last 
range, it uses the address 0000 and issues an error message for each 
word allocated following the last legal allocation. 

Suppose we use sequential allocation and specify the address space 
with a single absolute assignment as follows: 



.OCTAL 


.REGION/0202,0207/0312,0316 


.SEQUENTIAL 


LI: 


ni[Al] 


L2: 


M1[B2] 


0206 


: 


L3: 


«1 [3] 


U: 


Ml[i»] 


L5: 


Ml [5] 
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The addresses are allocated starting at the beginning of the region 
(0202) and continuing sequentially until the absolute assignment, as 
fol lows: 



0202 


LI 


0203 


L2 


020J* 


(unused) 


0205 


(unused) 


0206 


L3 


0207 


Ik 


0312 


L5 


0313 


(unused) 


03H 


(unused) 


0315 


(unused) 


0316 


(unused) 



Observe that Addresses 0204 and 0205 will not be allocated unless we 
force the allocator back with an absolute assignment. 



7-2.2 Random A 1 1 ocat i on 

In random mode, you can specify absolute address assignments and 
constraints. A constraint selects a set of addresses based on the low 
order bit configuration. Constraints are described in detail in the 
next section. 

MICR02 first allocates all absolute assignments and constraints and 
then allocates the remaining microinstructions starting at the first 
unallocated address in the first address-range and continuing 
sequentially through the unallocated addresses of the address space. 

Suppose we use random allocation instead of sequential for the 
preceding example as follows: 



.OCTAL 


.REG 1 ON/0202 . 0207/03 12,0316 


.RANDOM 


LI: 


H1[A1] 


L2: 


M1[B2] 


0206 


: 


L3: 


HI [3] 


U: 


HIM 


L5: 


HI [5] 
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|lCR02 allocates the absolute address assignment first and then begins 
at the first address in the address space and increments through the 
space to produce the following allocation: 



0202 


LI 


0203 


L2 


020** 


Li* 


0205 


L5 


0206 


L3 


0207 


(unused) 


0312 


(unused) 


0313 


(unused) 


031U 


(unused) 


0315 


(unused) 


0316 


(unused) 



7-2.2.1 Constraints - Many microprogrammable microprocessors perform 
conditional branching by ORing some logic function into the low order 
bit position of the next microinstruction address. MICR02 provides a 
constraint capability for generating a set of addresses for 
conditional branching. 



I 



constraint consists of an "-" character followed by a constraint 
string composed of a sequence of and 1 characters. 



A constraint specifies a set of addresses. In response to a 
constraint string, MICR02 chooses a base address that satisfies the 
low oraer bit configuration specified by the constraint. The bits of 
an address are always ordered from right to left. So the low order 
bit is the right-most bit. 



MICR02 then assigns the -ext n microinstructions to the addresses 
formed by systematically increasing the base address counting only in 
those bits designated as 0's in the constraint string. 



For example, suppose the constraint string is: 

-0101 

And suppose MICR02 chooses the base address 0225 (octal) . The binary 
representation of this address is: 

1098765^3210 
000010010101 

The low order bit configuration of the chosen address (0225) satisfies 
the constraint (0101). 
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MICR02 systematically increases the base address by counting in bits 1 
and 3. to produce a set of addresses ending in the following bits: 

0101 (base address) 

0111 

1101 

1111 



Since we are assuming that KICR02 chose 0225 for the base address, 
then the following addresses are assigned: 

0225 
0227 
0235 
0237 



MICR02 can choose any available address in the address space that has 
the low order bit specified by the constraint. MICR02 uses the first 
available audress that satisfies the constraint completely. That is, 
MICR02 uses the first address for which the base address and the 
addresses formed by oring the constraint possibilities with the base 
address are all available. 



7-2.2.2 Indicating a bit that can be or 1 - In addition to 0's and 
l's, you can use the character '*' in a constraint string. This 
character informs MICR02 that it can select an address that has either 
a or a 1 in that position for the base address. 



For example, the constraint 0101 specifies that the low order bit 
configuration must be or 1, whereas the constraint string 0*01 
specifies that the low order bit configuration can be either 0101 or 
0001. 



7.2.2.3 The size of the address set - The number of microinstructions 
in the set, n, is determined by the number of zeroes in the constraint 
string, as follows: 

n-2**X 

Where X is the number of 0's in the constraint string. 

For example, the constraint 0101 has two zeroes and thus determines a 
set of four microirstruct ions. 
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J.2.2.4 Constraints Within Constraints - If MICR02 encounters a 
constraint string within the set of instructions it is allocating to 
the block of addresses associated with an outer constraint string, it 
skips to the next address satisfying the inner constraint and then 
proceeds according to the algorithm specified by the outer constraint. 
The purpose of the nested constraint is to skip over some addresses 
that would otherwise be allocated by the outermost constraint. 



For example, suppose we have a constraint and a sequence of eight 
microinstructions labelled LO, LI, and so on, as follows: 



-000 

LO: 

LI 

L2 

L3 
Ik 

L5 
L6 

L7 



If MICR02 chooses the base address 0200, then it allocates the 
microinstruction labelled LI to 0200, L2 to 0201, L3 to 0202 and so 
|pn, as follows: 



Microinstructions 




Al location 


-000 






L0 


> 


0200 


LI 


> 


0201 


L2 


> 


0202 


L3 
L4 


> 

> 


0203 
0204 


L5 
L6 


> 

> 


0205 

0206 


L7 


> 


0207 



Now suppose we insert an inner constraint as follows: 



Microinstructions 



-000 


L0: M1[0] 


LI: Ml[l] 


-011 


L2 


HI [2] 


L3 


Ml [3] 


ik 


HI [4] 


L5 


HI [53 


16 


• Ml [6] 


L7 


• Hi [7] 





Al location 


> 


0200 


> 


0201 


> 


0203 


> 


0201* 


> 


0205 


> 


0206 


> 


0207 
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The inner constraint directs MICR02 to skip the 0202 assignment. Thus 
the total number of addresses within the constraint is seven and the 
instruction labelled by L7 is outside the constraint. Since MICR02 
can choose any address for L7. it allocates it after it has satisfied 
all the constrained addresses. 



Now suppose we insert another inner constraint: 



Microinstructions 




Al location 


-000 






L0: M[0] 


> 


0200 


LI: M[l] 


> 


0201 


-011 






L2: M[2] 


> 


0203 


L3: MC3] 


> 


C*20lt 


-110 






Li.: M[>] 


> 


0206 


L5: MC5] 


> 


0207 


L6: M[6] 






L7: M[7] 







The microinstructions labelled by L6 and L7 are now outside the 
constraint. 



7-2.2.5 Terminating a Constraint - A null constraint within the scope 
of the constraint terminates the constraint. A null constraint is the 
"-" character. A constraint can also be terminated by an absolute 
address assignment; however, in this case, MICR02 issues a warning 
message. 

Suppose we want to .— tstrain only five addresses. 



Microinstructions 




Al locat ion 


-000 






L0 


M[0] 


> 


0200 


LI 


M[l] 


> 


0201 


L2 


M[2] 


> 


0202 


L3 


MC3] 


> 


0203 


L*» 


• «W 


> 


020*4 


L5 


: «C5] 






L6 


: M[6] 






L7 


: «C7] 







The null constraint terminates 
microinstruction labelled by Ik. 



the 



constraint after 



the 
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|f.2.2.6 Address Space Boundaries - The set of constrained addresses 
allocated by MICR02 must lie within an address-range. Suppose you 
define the following address space: 

.REGION/0100,0177 

And suppose further, that MICR02 uses the addresses 0166, OI67, 1 76 , 
0177 to satisfy a constraint. If you define your space as: 

.REGION/0100,0167/0170,0177 

Then that set of addresses can no longer be used as a set because 
addresses 0166 and OI67 belong to one range whereas addresses 01 76 and 
0177 belong to another. 



7.3 MIXING ALLOCATION MODES 

You can switch between the two allocation modes in your program, as 
shown in the following program fragment: 





•TITLE 




.REGION 




.SEQUENTIAL 




.RANDOM 




.SEQUENTIAL 




* • • • 



} Bl 

} 



B2 



} 

} B3 

} 



In the above example, the .RANDOM and .SEQUENTIAL keywords divide the 
address space into U sub-spaces, according to the method of 
a I location. 



If you do not give an allocation mode, MICR02 assumes .RANDOM. Thus 
in the ^bove example, part A is allocated in the random sequential. 



CHAPTER 8 
COMMUNICATION 



This chapter considers two forms of communication: communication 
among memories in the same program and communication among separate 
programs . 



8.1 MEMORY COMMUN I CAT I ON 

Each memory has its own definitions, identification, and 
address-space. However, if the same field-name is defined in more 
than one memory, then the value-names defined for that field in any 
memory are known in all other memories that define the field. This 
feature lets you communicate between memories. 



For example, suppose you define two memories and designate the same 
field-name as the address field. You can then access the labels of 
one memory in the other as shown in the following example: 

.OCTAL 

.RTOL 

.UCODE 

A/-<12: 10> 

J/-<9:0>,. ADDRESS 
A/1.J/L2 
A/2.J/L3 
A/3.J/L1* 
.DCOOE 

B/-<9:0> 

J/-<16:10>,. ADDRESS 
B/0.J/L1 



LI 
L2 
L3 



Lk; 



The label name LI is a value name for the field J, which is defined in 
memory U. You can jump from the DCODE memory to the UCODE memory by 
specifying the label LI. 
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> 



2 PROGRAM COMMUNICATION 



You can assemble separate programs and load them together in a control 

store by handling address space assignment and communication. If, for 

example, you wish to have n separate programs, you divide the control 
store into n+1 logical spaces, namely: 

o Communication Space 
o Space for Program 1 
o Space for Program 2 

o Space for program n 



Suppose you want to assemble two separate programs for a control store 
of 2000 words. You might reserve the first 10 words for communication 
and then specify the address space for program \ as: 

.REGION/11,1200 

After you successfully assemble that program, you will know exactly 
what space it needs and you can specify the space for program I. 
Suppose the last word program 1 uses is 1053. You can specify the 
address space for program 2 as: 

Or you can reserve a little extra space for later expansion of program 
1 and specify the address space for prgram 2 as 

.REGION/1100,1777 

When both your programs are successfully assembled, you assemble the 
communication region: 





.REGION/0,7 




J. »<9:C~,. ADDRESS 


0: 


J/1400 


1: 


J/762 


2: 


J/21 



;Transfer to program 2 
;Transfer to program 1 (1) 
;Transfer to program 1 (2) 

You can, of course, dispense with the communication space and perform 
the transfers directly by fixing certain addresses in each program. 



CHAPTER 9 
A SAMPLE MICROPROGRAM 



In this chapter we define a sample machine and then give a 
microprogram that performs two subroutines, one to add the top two 
values of a stack and one to use the stack to determine the program 
control . 



We begin by defining the data path of the model mach ne and specifying 
the microinstruction fields. Then, we discuss the parts of the 
microprogram. First, we consider the identification part, then the 
field definitions, then the macro language, and finally the two 
subroutines. 



The input and output listings for the microprogram are given in 
Appendix B. 



9.1 THE DATA PATH 

The data path of the sample machine is shown in Figure 9-1. 

This architecture, while very simple, has the essential features of a 
machine, namely: 

o ALU - An arithmetic logic unit 

o PC - A program counter, which points to next instruction to 
be execu id 

o IR - An instruction register, which contains the current 
i nstruct ion 

c MA - A memory address register 

o An internal stack for data 

o Input and Output Buses 
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PC 




+ — 

1 


^ 

i 


i a. 


i 
!<— 

-L 1 


i + — ^ i 


| MA | J 




! W ! 




i + ► i 

II II 




II II 

+ + ► I 




\!/ 


STACK 


+ 


+ CACHE 



OUTBUS 



< h 



>+ 



i 
+- 



\!/ 



/!\ 



Tl 



ALU 





/!\ 

i 
i 
i 
i 


i 

i 

h 


/ 


A 


\ 


/i\ 




/|\ 


* ! 
i 
i 


B 


i 
i 

i 
i 



IR \;/ INBUS 
+ + 



I 
I 

+- 



MAIN MEMORY 



Figure 9-1. Model Machine Data Path 



Th« fol'owir.y sections specify the identification, define the fields 
of the microword for this data path, develop a macro language in terms 
of these fields, and us* this language. The input and output listings 
for this prograri are given in Appendix B. 



A SAMPLE MiukOPROGRAM 



Page 9~3 



9.2 iDF.NTIF I CATION 

The identification part of the program for the sample machine defines 
the bit-numbering as right-to-left, the base as octal, the allocation 
mode as random, and the word width as 23- 



9.2.1 Program Excerpt 

Here is the identification part of the program: 

+ + 

.title "machine model" 

.rtol 

.octal 

.random 

.width/23 



9.3 FIELD DEFINITIONS 

The sample machine has the following microword: 

2221111111111 
210S8765 1 »321098765 i »3210 

1 
1 

+ 



A A A A 



ALUJ 



CLKIR 



CLKT1 
SETCC 



|UBF 



MEMFNC 



SELT1PC 



Figure 9~2. Model Machine Microword 
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■•3-1 Program Excerpt 

Here are the field definitions that define this word: 



The following expression is used 
to make sure that Tl and PC are 
not both clocked at the same time. 

.SET/T1.PC«<.CASE[<CLKT1/>]0F[1,0] 

.toe "Field Definitions" 

.toe " ALU function for this microcycle" 
ALU/-<22:19>, .def aul t«<ALU/Zero> 



ADD - 
SUB - 1 
AND - 2 
OR - 3 

A - *4 
B - 5 
A+l - 6 
Zero- 7 



; Addition A + B 
rSubtraction B - A 
; Logical A .".ND B 
; Logical A OR B 
•Pass A through ALU 
;Pass B through ALU 
; Increment A A+l 
;2ero value 



.toe " IR Control" 
CLK!R/-<l8>,.default-<CLKIR/N0> 



NO - 
YES - 1 



;Do not clock IR 
;Load IR with data bus 



.toe " Tl Control" 

CLKT 1 /-< 1 7> , . def au 1 t-<CLKT 1 /N0> 



NO - 
YES - I 



;Do not change Tl 

;Load Tl with ALU output 



•toe " OUTBUS Control" 
SELT1PC/-<16>, .defaul t-<SELTlPC/Tl> 



Tl 
PC 





1 



;Tri -state Tl onto OUTBUS 
;Tri -state PC onto OUTBUS 
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.toe " Condition Code Control' 
SETCC/«<15>. .def aul t«<SETCC/NOP> 



NOP 
SET 




1 



;Do nothing with condition codes 
;Set condition codes according 
;to IR value and status of ALU. 



•toe " Memory Request Control" 

MEMFNC/-<U:12>,.default»<MEMFNC/N0P> 

;No operation. 

;Read top of stack onto INBUS. 
;Write data on OUTBUS to stack. 
;Load Memory Address with OUTBUS. 
;Read onto INBUS using MA. 
;Write OUTBUS value using MA. 
; INBUS gets PC. 
« 7, .VALIDITY-<T1.PC> ;PC gets OUTBUS. 

.toe " Branch Control" 
UBF/-<ll:10>,.default-<UBF/JUMP> 



NOP 





STKRD 


1 


STKWR 


2 


LOADMA « 


3 


READ 


k 


WRITE 


5 


READPC - 


6 


WRITEPC « 


7 



JUMP 
ALU 





1 



INSTR 
THREE 



2 
3 



Use next address field unchanged. 
Four way branch 

00 - Less than zero. 

01 - Largest negative number. 

10 - Greater than zero. 

11 - Zero 
Instruction decode. 
Reserved. 



.toe " Next Address Field" 
J/-<9:0>, .nextaddress 



9-J» MACRO DEFINITIONS 

The macros that define the language for the machine are divided into 
five categories; namely: 

o Stack interactions 

o Memory interactions 

o Arithmetic actions 

o Branch tests 

o Miscellaneous functions 



A SAMPLE MICROPROGRAM 



Page 9-6 



ft.lt. 1 Program Excerpt 

Here are the MICR02 macro definitions for the machine model: 



+ 

.toe "" 
"Macro Definitions" 



.toe 



Stack Interactions" 



Pop Stack 
Push Stack 
Stack Plus Tl 



"MEMFNC/STKRD, ALU/A, CLKT1 /YES" 
"MEMFNC/STKWR.SELT1PC/T1" 
"MEMFNC/STKRD, ALU/ADD, CLKT1 /YES" 



toe 



Memory Interactions" 



MA <— PC 

Tl < — Memory Data 
IR <-- Memory Data 



"SELT1 PC/PC, MEMFNC/LOADMA" 
"MEMFNC/READ, ALU/A, CLKT1 /YES" 
"MEMFNC/READ,CLKIR/YES" 



.toe " 

Tl <-- PC 
PC <— Tl 



Arithmetic Actions" 
+ 1 



MEMFNC/READPC.ALU/A+1.CLKT1/YES" 
SELT1PC/T1 .MEMFNC/WRITEPC" 



•toe " Branch Tests" 

ALUCC? "UBF/ALU" 

Instruction Decode "UBF/INST" 



•tor " Miscellaneous Functions' 
Set Condition Codes "SETCC/SET" 
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9.5 A SUBROUTINE 

The subroutine given below adds the top two values on the stack and 
replaces these values with the value of their sum, as represented 
below: 



+ + + 

1 1 i 

1 1 1 

+ j - 

z 1 > j 1 

+ + + 

X ' ' Z ' 
+ + + 

Y j i X + Y ] 
(. + + 



9. 5-1 Program Diagram 

The program to accomplish this function can be diagrammed as follows: 



j Read Stack j 

I value to Tl j 
+ + 

1 



\|/ 



Clock Tl 
ontc OUTBUS (B) 
Read Stack (A) 

Add A+B 





\ 


1 

:/ 




1 

1 


Push 


Sum 


1 


1 
1 


onto 


Stack 


1 
-+ 
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fc.5-2 Program Excerpt 

Here is the microprogram that accomplishes this function: 

+ + 

.toe "" 

.toe "Functions" 
" Add Top Two Values on Stack" 



ADD (SP) to (SP-1) 

This basic arithmetic instruction adds the top two values 
on the stack and replaces the result onto the stack. The 
condition codes are set according to the result of the 
addi tion. 



ADD01: 

Pop Stack, J/ADD02 ;Read stack value to Tl . 

ADD02: 

Stack plus Tl , ;Load Tl with (sp) + (sp-1) and 

Set condition codes, J/ADD03 ;save condition codes. 

AD003: 

Push stack, J/INSTFETCH ;Store sum on stack 



9-6 ANOTHER SUBROUTINE 

This subroutine uses the sign of the value on the top of the stack to 
determine where to send control. 

Suppose we have the following: 

instr. stream stack 
+ + + + 

1 111 

1 111 

+ + j ; 

Xi 1 11: 

A ' 1 11 1 

+ + + + 

pc --> X2 j X25 ! ! ! 

+ + + — . — + 

*3 ! ! 

+ + 

1 1 

1 1 

1 1 

1 1 

1 1 

1 1 

+ + 
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When the instruction XI is being executed, the program counter points 
to the next instruction X2, which contains the address of instruction 
X25- If the sign of the top of the stack is negative, control is sent 
to instruction X25. If not, control continues with instruction X3. 



9.6.1 Program Diagram 

The program to accomplish this function can be diagrammed as follows: 

Test Top of Stack 

Move PC to Memory Data 

1 

1 

+ + + + 

11 11 

11 11 

<0 <0 >0 

II II 

II II 

II II 

II II 



+ + + . 



I I 

I I 

I I 

\i/ \}/ 

Branch Skip 

on address next instruction 

Tl <— Mem Data Tl < — PC + 1 

1 1 

1 1 

1 1 

+ + + 

1 

\!/ 

PC <— Tl 



9-6.2 Program Excerpt 



Branch on Sign of Top of Stack" 



TEST (SP) and Branch if Negative 

This control instruction examines the top item on the stack 
If the value is less than zero then the next word in the 
instruction address stream contains the absolute address of 
the next instruction to be executed. Any other value 
causes the absolute address in the instruction stream to be 
skipped and execution continues normally. 

On entry to this routine, the PC points to the absolute 



J ; address. 
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On exit, the PC contains the address of the next instruction 
to be executed. The top item on the stack has been removed. 



TSTBN01: 

Pop Stack, J/TSTBN02 

TSTBN02 : 
MA <— PC. 

ALUCC?,J/TSTBN03 
-00 



Negative Number 

TSTBN03: 

Tl < — Memory Data, 
J/TSTBN08 



Largest Negative Number 



mTSTBNOl*: 

Tl < — Memory Data, 
J/TSTBN08 



;Test SP 



;Memory address of absolute 

; address. 

; Branch on conditior SP. 



;T1 < — Absolute address. 



;T1 < — Absolute Address. 



Greater than zero 

TSTBN05: 

Tl <— PC + 1.J/TSTBN08 ;Skip Absolute Address. 



Zero 

TSTBNOf: 

Tl <— PC + 1.J/TSTBN08 

TSTBN08: 

PC <— Tl.J/INSTFETCH 



INSTFETCH: 
J/INSTFETCH 



;Skip Absolute Address. 



;Load PC with next instruction 
; address. 



CHAPTER 10 
CONDITIONAL ASSEMBLY 



The conditional assembly capability lets you suppress the assembly of 
parts of your program. You select the parts of your program to be 
suppressed by the appropriate setting of expression-names 



Suppose, for example, you have a list processing package that consists 
of a common structure and a set of subroutines. Each subroutine is an 
entry point for the package. Sometimes you want to assemble this 
package with one set of entry points (or functions) and other times 
with another set. You can accomplish this by using the conditional 
assembly keywords. 



10.1 THE CONDITIONAL ASSEMBLY KEYWORDS 

Three keywords are provided for conditional assembly as follows: 

. I F/express i on-name 
. I FNOT/expr ess i on-name 
.ENDIF 

These keywords divide your program into blocks. 7*- F and .IFNOT 

keywords begin a block. They include an exp: -ssion-name that is 
associated with either a true (1) or false (0) value. These keywords 
have the following meaning. 

Keyword Meani ng 

. I F/express ion-name If expression-name is associated with a 

true value (1), assemble the following 
block. 

. I FNOT/express ion-name If expression-name is associated with a 

false value (0), assemble the following 
block. 

In practice, a value is any value that is not 1. For example, if the 
e/press ton-name has the value 2, MICR02 considers it to represent a 
false value. 
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^0. 2 



CONDITIONAL ASSEMBLY BLOCKS 



A conditional assembly block begins with either an .IF or .IFNOT and 
ends with either an . END I F for the same expression or another .IF or 
.IFNOT for the same expression. 

For example, suppose you have a portion of your program to be included 
only under some special condition. You can enclose that portion of 
the program in a conditional assembly block by branching it with .IF 
and .END IF keywords as follows: 











.IF/A 
.ENDIF/A 


[<- 


Part to be 
-included only 
if A is true 











Parts of program 
to be always 
i nc 1 uded 



10.3 AN EXAMPLE 

Suppose you have a sequence of conditional assembly directives, which 
divide your program into the following blocks: 





• IF/A 


! Al } 




. 1 F/B 

•ENDIF/B 


\ Bl } 




.ENDIF/A 


! A2 } 








1 




1 X 
1 A 


+ 




+ 



I F/B 



B2 



ENDIF/B 
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The block A is included if the value of A is true (1). However, 
within block A, the block Bl is included only if the value of B is 
also true. 

The portions of the program that arc assembled for the different 
values of A and B are shown in the following table. 

Case A Value B Value Program Portions Assembled 



1 
2 

3 

i» 



T 
T 
F 
F 



T A1 ,B1 ,A2,X,B2 (The entire program) 

F A1.A2.X 

T X.B2 

F X 



Block X is always assembled because it is outside all conditional 
assembly blocks. In Case 3t block Bl is not assembled because it is 
nested within the conditional assembly block controlled by A. 



10. 1» ANOTHER EXAMPLE 

Suppose you have a case in which you want to select some general code 

and then a set of one out of two pairs of options. You can use one 

expression-name to accomplish this binary decision, as follows: 



general code 



+ 

1 


.IF/A 


1 
1 


option 1 


1 


.1 KNOT/ A 


1 
1 


option 2 


1 
1 


.IF/A 


1 
1 


option 1 




.IFNOT/A 


1 
1 


option *. 


1 
1 


.IF/A 


1 

1 


option 1 


1 

1 


.IFNOT/A 


1 
1 

+ 


option 2 



Kl 



K2 



K3 



KA 



K5 



K6 



.ENDIF/A 
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ne portions of the program assembled are shown in the following 
Table: 

Case A Value Program Portions Assembled 

1 T X.K1.K3.K5 

2 F X,K2,Ki»,Kb 



10-5 SETTING AND CHANGING EXPRESSION-NAMES 

You define and set an expression-name with the .SET keyword as 
fol lows: 

.SET/express i on-name«express i on 

For example, to set the expression-name A to a true value for 
conditional assembly purposes, you use the following .SET directive: 

.SET/A-1 

Once you have defined and set an expression-name, you must use the 
.CHANGE keyword to change its value. Thus to change A to false, after 
©fining it as true above, you must write: 



I 



.CHANGE/A-0 



CHAPTER 11 
MICR02 LISTING AND LIST CONTROLS 



This chapter describes the input and output listings of MICR02 and the 
listing controls you can use to modify the format and content of the 
output 1 i stings. 



11.1 ASSEMBLER INPUT 

The input to the assembler is a microprogram. The microprogram 

consists of a sequence of lines, written in MICR02 source and 

conforming to the syntactic rules of that language. The input can be 
prepared using any available editor. 



This section discusses an example of assembler input. 



11.1.1 Preparing The Input 

The first step in preparing the input is writing the microprogram. To 
write a microprogram, you must be familiar with the internal details 
of the processor on which the program will run. 

You enter the microprogram source using any available editor. From 
the assembler's point of view, the microprogram consists of a sequence 
of lines beginning at the start of the first input file and continuing 
until the end of the last input file is encountered. Within those 
limits, the microprogram must have the expected structure. 



The assembler detects aid reports errors, as described in Appendix D. 
In response to these errors, you edit the input to obtain a valid 
microprogram. This process continues until either no errors are 
present or until you are convinced that the messages produced do not 
affect the validity of your microprogram. 
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11.1.2 Formatting The Microprogram 

Using a standard formatting scheme increases the readability of the 
microprogram. A standard format for the microprograms has been 
developed at DIGITAL and is given here for your information. 



11.1.2.1 The General Format - If a memory has any definitions, it 
begins with the identification keywords and continues with field 
definitions, followed by macro-definitions. 

Then the action-part of a microprogram is given. It consists of a 
sequence of microinstructions. 



11.1.2.2 Microinstruction Format - 

The rules for formatting a microinstruction are summarized as follows: 
1. Precede the microinstruction by any general comments. 



2. If the microinstruction has an explicit address, give that 
address at the left-margin and do not include any other 
information on that line. 

3. If the microinstruction has a label, give that label at the 
left margin and do not include any other information on that 
1 ine. 

U. Include as many instruction-parts, separated by commas, as 
will fit in the columns starting at the second tab (column 
17) end continuing to column 38 . 

5* Place any line-specific comments at the fifth tab (column 
M). 

6. If the allocation mode is random conclude the 
instruction-part with a branch to the next-address. 

7- Sepa-at? each microinstruction from the remainder of the 
microprogram by one or more blank lines. 



11.2 THE OUTPUT LISTING 

The output listing of a microprogram corresponds to the input listing, 
fxcept that the assembler prints some additional information, namely: 
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o A table of contents, formed by listing each .TOC line and 
.PAGE line with its assigned line number at the beginning of 
the output listing. 

o A line number at the beginning of each line. 

o Page headings at the top of each page. 

o fticroword information, giving the memory, address, and bits 
for each microinstruction in the microprogram. 

o Error messages, if any errors are detected. 

o A cross reference listing 

o A map 

o An error summary and statistics report. 

A brief description of each of the above items is given in the 
following sections. 



11.2.1 The Table Of Contents 

The table of contents is constructed by collecting the text on the 
.TOC and .PAGE lines to the beginning of the listing. Judicial 

placement of the .TOC and .PAGE lines within the listing results in a 

useful table of contents, by which you can quickly reference any 

logical section of the microprogram. As the size of a microprogram 
increases, the value of the table of contents increases. 



.TOC lines and the construction of the table of contents are described 
in detail in Chapter 2. A good example of the use of .TOC lines to 
produce a comprehensive table of contents can be found in the sample 
program in Chapter 9. 



11.2.2 Line Kumbers 

HICR02 numbers each input line. The line number is a decimal number, 
which starts at 1 and continues, in increments of 1, through 99999. 



Since blank lines and comments are assigned line numbers, it is not 
unusual for a small microprogram to occupy several thousand lines. 
However, the line limit of 99999 is seldom exceeded. 
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h.2.3 Page Headings 

The assembler divides the output listing into pages. Each page 

contains a heading line, a sub-heading line, and $k lines of the 

Microprogram. The page heading gives the following items of 
information: 

o The output listing file specification 

o The name and version number of the MICR02 assembler used in 
assembling the microprogram. 

o The time and date of the assembly. 

o The program title, as derived from the .TITLE line. 

o The page number . 

The sub-heading contains the following: 

o The input file specification 

o The subtitle derived from the last .TOC or keyword line. 



kf a .TITLE line is not given in the microprogram, then the title part 
f the heading is left blank. Similarly, if no .TOC or lines are 
given, the subtitle part is left blank. 



Page headings are illustrated in the sample output listing given in 
Appendix B. 



11.2.fc The Hicroword information 

The main-listing portion of the microprogram file is divided on the 
page into two fields. The left field contains the object part of the 
program, the octal or hexadecimal representation of the 
microinstruction. The right field contains the source part of the 
microprogram, as prepared by the user as input to MICR02. 



The width of tne left field is determined by the width of the widest 
microword in the program. 



You can give the listing control .NOB IN to suppress the object part of 
the microprogram. Listing controls are described in Section 11. 3. In 
such a case, the ma in- listing reproduces the input listing, except for 
fcny error messages placed there by MICR02. 
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The microword informat on contains the memory, address, and bits of 
the microword object, >n the following format: 

memory address digit ... 

For example, consider a microword line from the output listing in 
Appendix B. 

U 13, 10M.OOU* 

This line indicates that the octal word '101*100 IV is allocated to 
location 13 in memory U. 



11.2.5 Error Messages 

If an error is detected in a microprogram line, then an error message 
is printed by the assembler preceding that line. Error messages are 
easy to find within the listing because, instead of a line number, 
error messages begin with the string '????', followed by the error 
message. 

Appendix D lists all of the assembler error messages. 



11.2.6 The Cross Reference Listing 

The cross reference listing lists each name in the program and gives 
information about the places in which it appears. 

The cross reference listing consists of up to three parts, one for 
each of the following classes: 

o field and value names 
o expression names 
o macro names 

With the exception of field-names, the cross reference gives the name 
followed by an ordered list of line numbers. The line number on which 
the name is defined is followed by the '#' character. The other line 
numbers indicate the lines on which the name is referenced. 



The cross-reference listing for a field-name contains only the line 
number of its definition and any lines on which a field was referenced 
with a numeric rather than symbolic value. The set of value-names 
following define all the references to the field. 
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|s an example of a cross reference listing, consider the following 
excerpt from the cross reference given in Appendix B. 

ALU 14# 

A 20# 167 196 207 



This cross reference listing shows that the field name ALU is defined 
on line 14. The value name A is defined on line 20 and used on lines 
167. 196, and 207. 



11.2.7 The Map L i st i ng 

MICRC2 produces a map listing for each memory used in the 
microprogram. The map listing shows the addresses used by the 
microprogram and, for each address, the line number of the microword 
al located to it. 

A map listing line contains the memory- indicator, starting address, 
and a set of line indicators. A line indicator consists of the line 
number followed optionally by an "«" or ":" character. If the line 
number is followed by a "-", the location was allocated by a 

konstraint. If the line number is followed by a ":", the location was 
I located by an absolute address assignment. If neither of these 
characters is present, MICR02 chose the location according to its 
allocation algorithm for unconstrained addresses. 



The first line indicator identifies the line on which the starting 
address is allocated. The next line indicator identifies the line on 
which the starting address plus 1 is allocated, and so on. 



Consider the following line from the map listing in Appendix B. 
U 00 208- 215- 221* 144 147 150 154 



This line shows that location 00 in memory U is allocated according to 
a constraint on line 208. Location 01 is allocated according to a 
constraint on line 215. end so on. 



If an address within a map listing is not allocated, HICR02 leaves the 
corresponding space blank. If a range of addresses is blank, then 
those lines that have no allocated addresses are indicated by a 
message, as fol lows: 

lowbound-highbound Unused 
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11.2.8 The Summary 

The summary contains a list of all the errors MICR02 detected, a 
memory usage breakdown, and a count of the warning and total error 
messages. 

For each error detected, MICR02 gives the line number and the text of 
the message. 

For each memory, MICR02 gives the total number of microwords used and 
the highest address allocated. 

The error message count indicates how many warnings were issued and 
how many error messages were issued. Finally, the warnings and error 
messages are broken down into the number related to lexical processing 
and the number related to allocation and symbol resolution. 

11.3 THE ULD FILE 

The ULD file is the object file produced by MICR02. It consists of an 
optional header followed by a code section, followed by the set of 
field and address definitions used in the program. 



11.3-1 The Header 

The header, if present, contains information about the program radix 
and the direction in which the bits are numbered. 



11.3-2 The Code Section 

The code section contains the address and content of each microword to 
be loaded into the control store in the following format: 

[address] memory- id - contents 
For example, consider the following code-section line: 

[11]U - 16070012 
This line indicates that word 11 of memory has the contents 16070012. 
If the memory- indicator is not given, it is assumed to be U. 



MICR02 LISTING AND LIST CONTROLS Page 11-8 

|l-3-3 Field and Address Definitions 

In this section of the ULD file, all the field and field-value names 
defined in the U memory are given. 

A special control .ALLMEMF I ELDS is provided for those who want to see 
the field and address names from other memories as well as the U 
memory. 

For example, consider the following portion of a ULD file produced 
under the .ALLMEMF I ELDS control: 

field d fld/-<0:2> ;memory/d 

dvalT«i 

DVAL2-2 
DVAL3-3 
FIELD UC0DE_DATA_FLD/-<0:5> ;MEM}RY/U 

UVAM-1 
UVAL2-2 
UVAL3-3 

ADDRESS U JMP/-<6:12> ;MEKORY/U 

UADDR1-122 

UADDR2-222 
ADDRESS VING/-<3:19> ;MEMORY/D 

D_ADDR-11 

D_ADDR»12 

D~ADDR-13 

The above portion contains field-names from both the U and D memory. 
If, however, you do not give the .ALLMEMF I ELDS control, then only the 
field and address names from the U memory are given, as follows: 

FIELD UC0DE_DATA_FLD/-<0:5> 

UVAL1-1 

UVAL2-2 

UVAL3-3 
ADDRESS U JMP/-<6:12> 

UADDR1-122 

UACDR2-222 



11.4 LIST CONTROLS 

The list controls let you specify which portions of the output listing 
you want to see reflected in the output file. 

For example, suppose you have a long set of definitions. These 

definitions must be present for the successful assembly of our 

microprogram. But after the first few assemblies, you don't change 
these definitions and, therefore, want to suppress their listing. You 

xan accomplish this listing suppression by inserting a .NOLIST before 
the definitions and a .LIST after the definitions. 
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HICR02 determine:; whether or not to make a contribution to a file by 
looking at a counter. If the counter contains a positive number, 
MICR02 contributes to the associated file. If the counter is a 
negative number, MICR02 does not contribute. 

The list controls are as follows: 

Keyword Weaning 

•LIST Increment the listing counter 
.NOLI ST Decrement the listing counter 

.CREF Increment the cross reference counter 
.NOCREF Decrement the cross reference counter 

•B'N Increment the object counter 
.NOB IN Decrement the object counter 

.EXPAND List the field/value pairs produced by 
expanding macros after the last line of 
the instruction. 

.NOEXPAND Do not expand macros in the listing. 

At the beginning of an assembly, each counter has the value 0. 



1 1 . 4 . 1 The List Control Counters 



If a list control counter is positive, then HI CRG2 creates the 
specified part of listing. If a list control is negative, MICR02 
suppresses the specified part of the listing. 

The counter associated with the .LIST and .NOLI ST control determines 
whether or not an output listing is produced. The counter associated 
with the .BIN and .NOBIN controls determines whether or not the object 
part (left field) of the listing is produced. The counter associated 
with the .CREF and .NOCREF controls whether or not names will be added 
to the cross reference map. 



WCR02 LISTING AND LIST CONTROLS 



Page 11-10 



^uppose we add some list controls to a microprogram as follows: 



+ 

! .TITLE 

i 
i 
+ 

| .NOLI ST 

i 
i 
i 

| .LIST 
+ 

i 
i 
+ 

| .NOCREF 

i 

i 

j .CREF 

H 

J .NOLIST 

i 
i 

H 

! .NOBIN 
i 

i 

; .bin 

+ 

I 

I 

+ 



Fl 



F2 



These list controls partition the program for the purpose of output 
file creation. The listing file contains segments A, C, and D. The 
object file contains segments A, B, C, D, Fl, and F2. The cress 
reference file contains segments A, B, C, and F. 



The fact that the list controls operate with a counter allows you 
combine programs and still retain the same list control structure. 



to 
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Consider the following example: 



PROGRAM 1 




1 


1 A 


| .NOLI ST 

! Bl: 

i 


! B 

i 
i 
i 


j .LIST 


i 
i 
i 


! CI: 


! c 

i 

i 


! .NLIST 
i 

j .LIST 


1 

1 


i 
i 

i 
+ 


! e 

1 

1 

— + 



PROGRAM 2 



+ + 

! .NOLI ST j 

i ! Q 

! -LIST i 

+ + 

i : r 

i i 

i i 

+ + 

! .NLIST ! 

i ! s 

! .LIST I 

+ + 



If we assemble these programs separately, we get listing files as 
fol lows: 

Program Listing File Segments 



A, C, and E 
R 



We can insert program 2 in program 1 at any place and get the correct 
logical result. If we insert program 2 at Bl (that is, within a 
nonli sting segment), the listing of program 2 is suppressed. If we 
insert program 2 at CI (that is, within a listing segment), then the 
listing contrc ' s within program 2 are interpreted just as if they were 
when program 2 was a separate segment. 



CHAPTER 12 
USING MICR02 



To use MICR02, you invoke it at command level and then give a MICR02 
command line chat specifies the output and input files. This chapter 
describes the user interface in the VAX, DEC 10, and DEC 20 
envi ronments. 



12.1 VAX/VMS INTERFACE 

In the VAX/VMS environment, you call MICR02 at command level as shown 
toe low: 

Format 



MICR02 input-file-spec 
File Qual i f iers 



/LIST[-f ile-spec] 
/NOL I ST 

/ULD[-fi le-spec] 
/NOULD 



Prompts 

_File: input-file-spec 



F i le-Parameters 

Input-f i le-spec 

Specifies the names of one or more files to be assembled. If you 
specify more than one input file, you can use the character '+' 
to separate file-specs. 
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Description 

MICR02 assembles the programs contained in the input-file-spec 
and produces a listing file and an object file. 



File Qual i f iers 

/LIST [-file-spec] 

Specifies that you want a listing file. If you include a 
file-spec, MICR02 produces the listing in that file. If you do 
not include a file-spec, MICR02 uses the name of the input-file, 
or the name of the first input file in the case of multiple input 
files, with the default extension .MCR for the listing file. The 
listing file is described in Section 112. 

/NOLI ST 

Specifies that you do not want a listing file. 

/ULD [-file-spec] 

Specifies that you want an object-file. If you include a 
file-spec, MICR02 produces the object file in that file. If you 
do not include a file-spec, MICR02 uses the name of the input, or 
the name of the first input file in the multiple input file cape, 
with the default extension .ULD for the object file. The object 
file is described in Appendix C. 

/NOULD 

Specifies that you do not want an object-file. 



Examples 

1. MICRO! ALPHA 

MICR02 assembles the program in the file ALPHA. MIC and 
produces a listing file ALPHA. MCR and the object file 
ALPHA. ULD. 

2. MICR02/UST-BCTA ALPHA 

MICR02 assembles the program in the file ALPHA. MIC and 
produces the listing file BETA. MCR and the obJect file 
ALPHA. UlC. 

3- MICR02/N0ULD ALPHA+GAMMA 

MICR02 assembles the program formed by the concatenation of 
ALPHA. MIC and GAMMA. MIC and produces the listing file 
ALPHA. MCR. 

4. MICR02/LIST-BETA/N0ULD ALPHA 

MICR02 assembles the program in the file ALPHA. MIC and 
produces the listing file BETA. MCR. MICR02 docs not produce 
an object file because the qualifier /NOULD is given. 
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P i 1 e-Spec i f i cat i ons 

MICR02 accepts and processes any legal VAX filename. For purposes of 
error reporting, MICR02 abbreviates long filenames by truncating the 
name to the first six characters and the extension to the first three 
characters. 



12.2 DEC 10 COMMAND LINE INTERFACE 

To invoke MICR02 at command level on the DEC 10, you type one of the 
fol lowing : 

R MICR02 command- information 

R MICR02 



If the command information is not given in the invocation, MICR02 
prompts for the command information with an asterisk (*) character. 

The command Information consists of the listing-file followed by a 
comma followed by the file-specification for the object file followed 
by an "■" character fol' owed by the input file-specifications. That 
s, the form of the command information is: 



I 



listing-file, object-file ■ {input-file}, 



If you give more than one input file, the assembler reads the 
microprogram from the specified input files in the order given in the 
assembly-command-1 ine. The first input file is read, then that file 
is closed and the second file is opened. Processing continues with 
the second input file, again until an end-of-file, indicating the end 
of input on that file, is ready. Process mg continues in this way, 
moving from file to file, until all files are processed. The input 
files must not contain any line numbers. MICR02 rejects such files. 

The assembler produces the output listing on the listing-file. If a 
listing-file is not specified, then MICR02 uses the name of the first 
input file and the extension .MCR for the name of the listing file. 
The output listing is described in Section 11.2. 



Tie assembler produces the load module on the object-file and that 
file csn be subsequently given as an input file for the microprogram 
loader. If an object-file is not specified, no load module is 
produced. The format of the load module is described in Appendix C. 



USING MICR02 Page 12-1+ 



You get an object file s if you specify an object file name or if you 
include the "," character preceding it. consider the following MICR02 
cal Is: 

Cal 1 Result 

R MICR02 A,B=C MICR02 assembles the program in the file 

C.MIC and produces the listing file A.MCR 
and the object file B.ULD 

R MICR02 A,«C MICR02 assembles C.MIC and produces the 

listing file A.MCR and the object file 
C.ULD 

R MICR02 ,B-C MiCR02 assembles C.MIC and produces the 
object f i le B.ULD 



12.2.1 File Specification? 

A file specification has the following form: 

diskname:f i lename.ext[PPN] 

Diskname, ext, and PPN are all optional. If diskname or PPN are 
omitted, the user's default disk or PPN is assumed. 

12.3 DEC 20 INTERFACE 

You invoke MICR02 on the DEC-20 system just as on the 10 system, the 
only exception :s that instead of typing R followed by MICR02 *.' 
command level, you simply type MICR02, as follows: 

MICR02 



APPENDIX A 
MICR02 LANGUAGE SYNTACTIC SUMMARY 



This appendix provides a quick reference to the HICR02 language. 
First, the syntax of the language is given. Then a summary is given 
of the elements used to build a MICR02 source program. 



A.l MICR02 SYNTACTIC SUMMARY 

The MICR02 syntactic summary gives the syntax, restrictions, and 
defaults for the MICR02 language. Following this information, 
Examples of the syntax are given. 



The syntax notation used to express the MICR02 language is the same as 
the syntax notation used in the BLISS Language Guide (AA-H275A-RK) . A 
detailed description of the notation is contained in Chapter 3 of that 
manua 1 . 



Briefly, a syntactic rule is given in a box. The left part of the box 
contains the syntactic name being defined. The right side of the box 
contains the definition. 

Concatenation is expressed in the definition by writing the terms one 
after another. An example of a concatenation is: 



field-contents- indicator f ield-n 



The above rule defines a field-contents-indicator to be a field-n, 
followed by the character '/'. 

disjunction is expressed by enclosing the possible terms in braces and 
distinguishing the possibilities either by separating them by the 
character '{' or by giving them on separate lines. An example o a 
disjunction is: 
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octal-digit WJ 1 J2 J3|*i5!6j7) 



The above rule defines an octal digit to be a '0' or a T or a '2' 
and so on. 



Another example of a disjunctin is: 



{ octal -number } 
number { dec i ma 1 -number } 

{ hexadecimal -number } 



Omission is indicated by including the term 'nothing' as a possibility 
in a disjunction. An example of omission is: 



{ : right-bit } 
field-spec < left-bit { nothing } > 



The above rule defines a field-spec to be either a '<' followed by 
left-bit followed by ':' followed by right-bit followed by '>' or a 
'<' followed by left-bit followed by •>' . 

Finally, replication is indicated by the character sequence '...'. If 
the replication contains a separator, the separator appears as the 
first character. An example of replication is: 



arg-part [ argument .... ] 



The above rule defines 'arg-part' to be a ' [' followed by one or more 
arguments separated by ',' followed by ']'. That is. the following 
are all valid definitions of 'arg-part': 

[ argument ] 

[ argument, argument ] 

[ argument, argument, argument ] 
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.1.1 The Program 



program 



.LTOR 
.OCTAL 



.RTOL J nothing } 
.HEXADECIMAL | nothing } 



ry 



i dent i f i cat i on-par t 
definition-part 
micro instruct ion -part 



i dent i f i cat i on-par t 



ry- indicator 
WIDTH/word-width 



nothing } 
nothing } 



.TITLE/" " ! nothing } 
.VERSION/" " ! nothing } 
.REGION {/low-address, high-address} 



1 nothing 



.RANDOM | .SEQUENTIAL J nothing } 



ry- indicator 



{ .UCODE i .DCODE j .ECODE | 
{ .OCODE ] .CCODE 



.MCODE 



I CODE } 
} 



word-width 



decimal -integer 



low- address 
high-address 



express i on-subject-to-program-r ad ix 



A.l 



.1 Defaults - 




memory- i nd i cator 


.UCODE 


program-radix 


.OCTAL 


bi t-order 


.LTOR 


al location mode 


.RANDOM 


word -width 


highest bit specified in 




field-definition 




plus 1 



A. 1.1. 2 Restrictions 



1. < word-width <- 128 

2. low-address < high-address 
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A.l .1.3 Examples - 

.RTOL 
.OCTAL 
.DCOOE 
.WIDTH/6i. 

.REGION/0100,0177 
.RANDOM 



A. 1.2 The Definition Part 



definition-part { field-definition } 

t macro-definition } 



{ , qual if ier . . . } 
field-definition f ield-name/'f i eld-spec { nothing } 

{ value-name - value-spec }... 



{ : right-bit } 
field-spec < left-bit { nothing } > 



{ .DEFAULT - expression } 

{ .ADDRESS } 

qualifier { .NEXTADDRESS } 

{ .VALIDITY - expression } 

{ .FLOATEPARITY } 

{ .FLOATOPARITY } 



{ {tl -value} {.t2-va1ue}} 
{ , {nothing } {nothing }} {.VALIDITY} 
value-spec value { nothing } {nothing } 



field-name } 
value-name } 



-char { name-char { space } . . . } 
{ { nothing } } 



-char { letter J number J special -char } 
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•- 



{ < : > 



letter 




{ A 


a 


B 


b ! 


... ! z j 2 } 






number 




{ 


1 


2 




! 9 ) 






special 


-character 


{ ! 


* 


; & 


( : 


)!*:+!-! 


• ? 


_} 



space 



{ space-character ... } 



space-character 



{ blank ! tab } 



left-bit } 
right-bit } 



decimal-i nteger 



value 



integer-subject-to-program-radix 



A. 1.2.1 Restrictions - 



1. If .LTOR specified, then in a field-spec left-bit 
>- right-bit 

If .RTOL specified, then left bit <- right-bit 

2. Either .NEXTADDRESS or .ADDRESS must be specified 
once and only once per memory. 



k. 1 .2.2 Examples - 
field-definition 



CLKTl/- <17>. -default - <CLKT1/N0> 
NO - ;Do not clock Tl 
YES - 1 ;Loa£ Tl with ALU output 
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A. 1.3 Expressions 



expression 



{ number 

{ expression-name 
< { field-conten s-indicator 
{ field-value-identifier 
{ function-cal 1 



number 



{ octal -number } 
{ decimal -number } 
{ hexadecimal -number } 



octal -number 



octal -digi t . . 



decimal -number 



decimal -digit ... decimal -poi nt 



hexadecimal -number hex-digit 



octal -dig it 



{0|lj2|3!'.!5!6!7} 



